Currently, as ChurchCRM is still in development, an install script is not yet available. ChurchCRM can run on a LAMP server (Linux, Apache, Mysql, PHP) or a Shared Hosting account through a manual installation.
Check your server
check.php to your web server's document root, and then visit
check.php in a web browser.
This page should tell you everything you need to know to determine whether or not you can run ChurchCRM.
[More at our check repo] (https://github.com/ChurchCRM/Check)
How Do I Install ChurchCRM?
[Download the latest release] (https://github.com/ChurchCRM/CRM/releases/latest)
The downloaded zip file contains a directory called "churchcrm". Extract the files and place the contents into a directory in the document root of your Web server or via FTP to a shared hosting account
Create a Church CRM blank db and user that have full permissions on the db.
For shared hosting accounts you must create a database within your hosting control panel
For LAMP servers, log onto your database server under the root account (or other account allowed to create databases), and create a database for ChurchCRM.
mysqladmin -u [user] -p create [database-name]
You should be able to access ChurchCRM at "http://[servername]/churchcrm". The setup page will help you configure the app for first-time use.
The database script will have set up an initial user called "Admin" with a password of "changeme" (passwords are case insensitive). 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 priviledges.
At the top right of the page select the gear icon ⚙ then select >>Edit General Settings
- You might want to change the
sDefaultPassto something that pertains to your organization. This is the default password that all new accounts are assigned until they log in and set their own.
sDefaultCityto the location for your organization
sDefaultState(This must be a two letter abbreviation)
sToEmailAddressto the default email address you want requests to come to (ie.
sSMTPHostas the email relay server.
SMTPPassto the credentials for the email account.
sChurchLatitude(You can find this information at http://www.latlong.net/)
sChurchLongitude(You can find this information at http://www.latlong.net/)
sHeader. You can add a custom header to ChurchCRM by entering the HTML for the custom header. Example: If you enter
<H2>My Church</H2>, ChurchCRM will display "My Church" in large, bold letters at the top of each page.
mailChimpApiKey. MailChimp is a web service that makes it easy to send and track bulk emails. If you do not have an account, create a free one here: http://mailchimp.com/signup. Once you have an account, create an API Key at http://kb.mailchimp.com/accounts/management/about-api-keys and enter that value into this setting.
At the top right of the page, select the gear icon ⚙ and then select >>Edit Report Settings. The settings in this section define various reports, such as giving statements.
These are the different signatures used on your financial reports.
Letter Head Graphic
Register your copy
At the top right of the page select the gear icon ⚙ and then select >>Update Registration. This information is used to inform you of updates to the system.
- If you are using the database backup utility, make sure the churchcrm/SQL directory is not accessible to your users! Otherwise, with the right timing, anybody can download and read the temporary files used in creating database backups. Different web servers have various means of access control. For example, in Apache you might add this to your httpd.conf:
Please see your web server's documentation if you need further help.