-
-
Notifications
You must be signed in to change notification settings - Fork 536
Home
Installation, user guides, administration, and troubleshooting have moved to the official documentation site.
👉 docs.churchcrm.io — use this for all non-developer manuals (installation, first run, user guide, upgrade, backup, troubleshooting, FAQs).
This wiki is kept for developer-focused content only: contributing, code style, APIs, database structure, release process, and plugin development.
| You are… | Go to |
|---|---|
| End user or administrator | docs.churchcrm.io |
| Developer (contributing, code, APIs) | This wiki (sections below) |
Old wiki link? → Documentation Links: Wiki → Docs — full table of where each wiki page moved.
ChurchCRM is a free, open-source, web-based church management system that helps churches manage their congregations effectively. It runs on any LAMP stack (Linux, Apache, MySQL, PHP) and is mobile-friendly.
ChurchCRM exists to serve the Church — every congregation, in every country, in every language. We believe that God's people deserve world-class tools without the burden of licensing fees, vendor lock-in, or data ownership concerns. This software is our ministry: open-source, community-built, freely given.
Our goal is to make ChurchCRM the most discoverable, trusted, and beloved free church management software in the world.
- 👥 People & Families — Manage member profiles, families, and classifications
- 📅 Events & Groups — Track attendance, manage groups, and organize events
- 💰 Finances — Handle pledges, donations, and generate tax statements
- 📧 Communications — Send emails and generate reports
- 🌍 Localization — Available in multiple languages
View all features → (docs)
Day-to-day usage of ChurchCRM — docs.churchcrm.io
| Getting Started | Core Features |
|---|---|
| User Guide | Families & Persons |
| Search | Groups & Events |
| FAQs | Finances |
Server setup and system maintenance — docs.churchcrm.io
| Setup | Maintenance | Troubleshooting |
|---|---|---|
| Installation | Upgrade | Troubleshooting |
| System Requirements | Backup & Restore | 500 Error |
| First Run Setup | Users & Permissions | Logging & Diagnostics |
Contributing to ChurchCRM — this wiki
There are two ways to contribute as a developer, and both are equally valuable:
Fix bugs, add features, improve performance, or expand test coverage in the main ChurchCRM codebase.
Add a feature ChurchCRM doesn't have yet — a third-party integration, a specialized workflow, a custom report — without touching the core code. Plugins survive upgrades and can be shared with other churches.
| Plugin Development | Reference |
|---|---|
| Creating Community Plugins | AI Agent Workflow → Plugins |
| Tabler UI Components | Leaflet Maps Integration |
Not sure which path to take? If the feature would benefit all ChurchCRM users, contribute it to the core. If it's specific to your church's workflow, or integrates a third-party service that not every church uses, a plugin is the right fit.
👉 Official Installation Guide — Recommended starting point
Full installation & setup docs: docs.churchcrm.io
After installation:
- First Run Setup — Configure your church details
- Features Overview — Learn what ChurchCRM can do
- User Guide — Detailed guides for each feature
- 💬 GitHub Discussions — Ask the community (most active)
- 🐛 Report Issues — Found a bug? Let us know
- ❓ FAQs — Frequently asked questions
- 🔧 Troubleshooting — Common issues and solutions
The application is built around people, families, and groups. After you successfully install and log in:
- Enter your Church Details: Church name, address, phone, and email (Report Settings)
- Plan your setup:
- Which groups will you use?
- What custom fields do you need?
- Who needs access to different features?
- Who manages finances?
- Explore the Features Overview to learn what's available
- Read the User Guide for specific feature guides
- Start with your people and families data
- Configure groups for your organization structure
ChurchCRM supports multiple languages. See:
- Localization (docs) — How translations work and server configuration
- For Translators (wiki) — Contributing translations
- Test the system before you import real data: Importing Demo Data via Admin Pages
- Home
- Wiki → Docs links — User & admin manuals moved to docs.churchcrm.io
→ docs.churchcrm.io for installation & setup
- Installation ← Start here!
- First Run Setup
- Features Overview
→ docs.churchcrm.io for user manuals
- User Guide (docs)
- People Management — docs
- Groups & Events
- Tools
- Finances
→ docs.churchcrm.io for admin manuals
- User Management
- System Maintenance
- Configuration
- Troubleshooting
- Localization
Contributing to ChurchCRM
- Quick Start
- Testing & CI/CD
- Code & Architecture
- Localization
- Release & Security