Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Installing ChurchCRM in Cpanel shared hosting
Installing ChurchCRM in Cpanel/shared hosting
- login to your website Cpanel
- if you want to install ChurchCRM in a subdomain e.g.
http://churchcrm.mywebsite.org, you should create the subdomain "churchcrm" using cpanel's "Subdomains"
- if you want to install ChurchCRM in a subdirectory e.g.
http://mywebsite.org/churchcrm, create the subdirectory "churchcrm" in your webroot using cpanel filemanager (usually:
- You can also install in your webroot e.g
/home.../myusername/public_html/) [NOTE:- if using the root directory, when extracting the zip file or uploading, all files in the folder "churchcrm" should go into your webroot]
- Go to cpanel's "MySQL databases" to create a new database e.g myusername_myChurchCRM
- Asign/Add a user to the newly created database ("Add a User to a Database") or
- Create a new user and set password for the created database e.g myusername_ChurchCRMAdmin ("MySQL Users, Add a New User") grant all priviledges to the user.
- Download ChurchCRM latest release https://github.com/ChurchCRM/CRM/releases/latest
- Upload ChurchCRM application files to yor website. Use the following steps for an FTP upload or follow "Using Cpanel's Filemanager" below:
- Extract the downloaded ChurchCRM zip file to a directory on your computer (The downloaded zip file contains a single directory called "churchcrm")
- Use an FTP client (e.g. filezilla) to upload all the files in the directory "churchcrm" to your prefered website directory (steps 2,3,& 4 above)
- change all ChurchCRM files and directory permissions to 0755
- Using Cpanel's Filemanager
- In Cpanel's Filemanager, upload and extract all the files in the ChurchCRM zip file you downloaded in step 8 to your preferred installation directory (steps 2,3,& 4 above) (be aware that the zip file contains a single directory "churchcrm" you need to get all the files in that directory to your prefered directory)
- This is the tedious part (and why you should use FTP or SSH) change permissions on all files and directories to 755
- You should be able to access ChurchCRM at "
http//mywebsite.org/churchcrm(for a subdirectory and subdomain install) or "
http//churchcrm.mywebsite.org" (for a subdomain install), or
http//mywebsite.org(for web root install)
- The setup page will help you configure the app for first-time use.
The database script would have set up an initial user called "Admin" with a password of "changeme". You will be prompted to change this password upon login. Once you have created other user accounts, you may delete or rename this default account. Just make sure that you always have a user with administrative privileges.