Self Hosting on Linux

Self-hosting on Linux

Quick reference for Linux-based ChurchCRM installations.

Installation Guides

• Rocky Linux 8 - Recommended for new Linux installations
• Development Setup - Set up local development environment with Docker

System Configuration

PHP Max Execution Time

While most ChurchCRM functionality works fine with low max_execution_time, some operations need higher values:

• Backup/Restore: May require 120+ seconds
• Large data operations: Depends on database size, photos, server speed

To increase:

# Edit php.ini
sudo nano /etc/php.ini
# Change or add: max_execution_time = 300
# Restart Apache: sudo systemctl restart httpd

More details: PHP Max Execution Time Guide

Rocky Linux Repositories

To add the Remi repository for useful PHP packages:

# Enable extras repository
sudo dnf config-manager --set-enabled extras

# Install EPEL (Extra Packages for Enterprise Linux)
sudo dnf install epel-release

# Install Remi repositories
sudo dnf install https://rpms.remirepo.net/enterprise/remi-release-8.rpm

# Verify Remi-modular is enabled
dnf repolist

System Locale (Localization)

To set the system locale for ChurchCRM translations:

1. Set system locale (example: Spanish)

   sudo locale-gen es_ES

2. In ChurchCRM Admin:

   • Click Admin → Edit General Settings
   • Select Settings tab
   • Click System Settings
   • Select Localization tab
   • Change sLanguage to your desired language

SSL/HTTPS Security

ChurchCRM highly recommends running with SSL configured:

• ChurchCRM indicator: Will show admin task if SSL not detected
• HSTS support: Can issue HTTP Strict Transport Security header

To enable HSTS:

• Click Admin → Edit General Settings
• Select System Settings tab
• Scroll to bHSTSEnable
• Set to TRUE

---

External Resources

• Installing on Ubuntu 18.04+ - Community guide for Ubuntu/Debian-based systems

Note: External guides may reference older PHP versions. Verify System Requirements for current PHP version needed.

See Also

• Installation Hub - All installation methods
• System Requirements - PHP, database, and server requirements
• Troubleshooting - Fix common issues