ChurchCRM documentation
Install ChurchCRM, configure it, and use it day to day.
Start at the official ChurchCRM website for product overview, live demo access, and installation entry points.
I'm installing ChurchCRMβ
For administrators setting up ChurchCRM for the first time.
- Installation Overview β Choose your hosting method and get started
- System Requirements β PHP, database, and server prerequisites
- Self-Hosted on Rocky Linux β RHEL/Rocky Linux install guide
- Self-Hosted on Ubuntu / Debian β Ubuntu 22.04/24.04 LTS install guide
- cPanel Shared Hosting β Shared hosting setup
- Azure β Microsoft Azure cloud setup
- SSL / HTTPS β Secure your installation
I'm a staff userβ
For church staff and end users working with the application day-to-day.
- User Guide β Guides for all features
- People & Families β Manage member profiles and family records
- Groups β Organize members into groups
- Events β Track attendance and manage events
- Finances β Pledges, donations, and tax statements
- Search β Find people, families, and records quickly
I'm the adminβ
For ongoing system management and maintenance.
- Administration Overview β Settings, users, and system configuration
- First Run Configuration β Initial setup after installation
- Upgrade Guide β Update to a new version
- Backup & Restore β Protect your data
- Users β Manage user accounts and permissions
- Email Setup β Configure SMTP for notifications
- Background Jobs & Scheduler β Configure scheduled jobs introduced in 7.7
- Maps & Geocoding β OpenStreetMap / Nominatim (no API key required)
- Troubleshooting β Common issues and solutions
- FAQs β Frequently asked questions
Quick Referenceβ
| I need to⦠| Go to |
|---|---|
| Install ChurchCRM | Installation |
| Add a person | Persons |
| Add a family | Families |
| Create a group | Groups |
| Record attendance | Events |
| Manage donations | Finances |
| Configure scheduled jobs | Background Jobs |
| Upgrade ChurchCRM | Upgrade |
| Back up my data | Backup & Restore |
| Fix a problem | Troubleshooting |
Get Helpβ
Can't find what you need in these docs?
- Ask on Discord β questions, setup help, and how-to advice
- Open a GitHub issue β a bug, or a gap in the product, on the ChurchCRM repository
Can't find what you need? Ask in Discord, or open an issue on the ChurchCRM repository.