Back to Home

Install ChurchCRM

Self-host ChurchCRM on your own server for complete control and privacy

Softaculous Auto-Installer cPanel Direct Download from GitHub Home
Three Simple Steps

Choose the installation method that works best for your hosting setup

Live ChurchCRM product demo Official ChurchCRM installation documentation

Softaculous Auto-Installer vs Manual cPanel Installation vs Direct Download from GitHub

1

Softaculous Auto-Installer

One-click installation available on many hosting providers with cPanel

Learn More
2

Manual cPanel Installation

Step-by-step guide using cPanel's file manager and MySQL tools

Learn More
3

Direct Download from GitHub

Full control installation using FTP or command line

Learn More

System Requirements

System Requirements

  • PHP Version: 8.4+ (required for v7.0.0+)
  • Database: 8.0.11+ or MariaDB 10.5+
  • Web Server: 2.4+ with mod_rewrite
  • Memory: 256MB minimum (512MB+ recommended)
  • Execution Time: 30+ seconds minimum
  • Disk Space: Minimum 500MB available

PHP Extensions

  • php-bcmath, php-curl, php-exif, php-gd
  • php-gettext, php-intl, php-json, php-mbstring
  • php-mysqli, php-soap, php-sodium, php-xml, php-zip

Most hosting providers include these by default

Database User Permissions

The database user must have these permissions:

  • CREATE: To create tables and indexes
  • ALTER: To modify table structures during updates
  • SELECT, INSERT, UPDATE, DELETE: To read and write data
  • EXECUTE: To run stored procedures
  • CREATE VIEW: To create database views

Tip: In cPanel, selecting ALL PRIVILEGES grants all permissions.

Method 1: Softaculous One-Click Installation / Method 2: Manual cPanel Installation / Method 3: Direct Installation from GitHub

Method 1: Softaculous One-Click Installation

Recommended if available - Easiest and fastest!

1
Log in to your hosting control panel (cPanel)
  1. Log into your cPanel account
  2. Look for Softaculous or Application Installer in Software section
  3. If you see it, Softaculous is installed!
2
Find the Softaculous or 'Install Software' section
  1. Click on Softaculous in cPanel
  2. In the search box, type ChurchCRM
  3. Click on the ChurchCRM icon to view details
3
Search for ChurchCRM and click Install
  1. Click the green Install Now button
  2. You'll see the installation form
4
Follow the prompts to complete installation
  • Installation URL: Select your primary domain
  • Directory: Leave blank for root, or enter subdirectory name
  • Admin Username: Create a secure username
  • Admin Password: Create a strong password
  • Admin Email: Enter the admin email
  • Site Name: Enter your church name
  1. Click Install button
  2. Softaculous handles everything automatically
  3. Installation completes in 2-5 minutes
  4. Log in with your credentials

Method 2: Manual cPanel Installation

If Softaculous isn't available, follow these manual steps.

1
Create a MySQL database using cPanel MySQL Databases
  1. In cPanel, find and click "MySQL Databases"
  2. Create a new database (e.g., churchcrm_db)
  3. Create a new MySQL user with a strong password
  4. Add the user to the database with ALL PRIVILEGES
  5. Note your database name, username, and password
2
Download ChurchCRM from GitHub
  1. Download from GitHub Releases
  2. Unzip the file on your computer
  3. Get files ready to upload
3
Upload files via File Manager or FTP
  1. In cPanel, click "File Manager"
  2. Navigate to public_html directory
  3. Upload all ChurchCRM files
  4. Set file permissions to 644 (files) and 755 (folders)
4
Visit your installation URL and follow setup wizard
  1. Open your browser and go to your ChurchCRM URL
  2. The installation wizard will load automatically
  3. Enter your database information
  4. Create your admin account
  5. Complete the wizard

Method 3: Direct Installation from GitHub

For any web hosting with PHP and MySQL.

1
Clone or download from GitHub: https://github.com/ChurchCRM/CRM
  1. Go to ChurchCRM Releases
  2. Download the latest zip file
  3. Unzip on your computer
2
Create a MySQL database on your server
  1. Use your hosting control panel to create a MySQL database and user
  2. Note the database name, username, and password
3
Upload files to your web server using FTP or SFTP
  1. Connect via FTP or use your hosting's file manager
  2. Upload files to web root (public_html, www, or httpdocs)
  3. Set file permissions: files to 644, folders to 755
4
Run the installer at your installation URL
  1. Visit your ChurchCRM URL in a browser
  2. The setup wizard will appear
  3. Enter your database credentials
  4. Complete the configuration

Need Help?

Documentation

Comprehensive guides and troubleshooting

View Documentation

Community

Connect with other churches

Ask the Community

Contact

Reach out for direct help

Contact Support

Ready to install?

Most churches use Softaculous or cPanel Manual installation. Both provide full control and integrate with existing hosting.

Want to see it first? Try the Live Demo · Explore features

Download from GitHub Home
Help Demo