Self‐Hosted on RockyLinux

The purpose of this page is to provide the requirements and steps needed to install/run ChurchCRM on a self-hosted linux machine running RockyLinux (currently v8.9).

Prerequisites

• mariadb-server
• httpd (apache web server)
• php8
• npm (if running from git clone)

Suggested install commands:

• sudo dnf install httpd mariadb mariadb-server

PHP Installation

It may be possible to run with the stock RockyLinux php packages, but it seems to be easier to use modular packages from the remi repository, and instructions for this are provided below:

• To enable the needed remi repository, see: Adding Extra RockyLinux Repositories
• sudo dnf module reset php
• sudo dnf module enable php:remi-8.1
• sudo dnf install php php-cli php-fpm php-mysqlnd php-zip php-curl php-gd
• sudo dnf module enable composer:remi:2
• sudo dnf install composer

Configure MariaDB

• Mariadb
  • Edit /etc/my.cnf.d/mariadb-server.cnf if desired to change db file location
  • Start mariadb: sudo systemctl start mariadb
  • Secure the setup, and set a root password: sudo mysql_secure_installation
  • Create the churchcrm database: mysqladmin -u root -p create churchcrm
  • Then create the churchcrm user and set a password for that user:
    • mysql -u root -p
    • CREATE USER 'churchcrm'@'localhost' IDENTIFIED BY 'YourDBPasswordHere';
    • GRANT ALL PRIVILEGES ON churchcrm.* TO 'churchcrm'@'localhost';
    • FLUSH PRIVILEGES;

Different Run-time Options

Running from source (i.e. development, running from a git repository)

• Once OS pkgs are installed, the following steps are used from a clean 'git pull' on master

  • composer install (from src dir)
  • composer --dev install (from src dir, to install needed dev tools [phpcs])
  • npm install
  • npm run deploy

Running from a Downloaded Release Artifact

(e.g. a zip file such as: https://github.com/ChurchCRM/CRM/releases/download/5.6.0/ChurchCRM-5.6.0.zip)

• This zip file will need to be unzipped in an appropriate area within your webserver's Document root.
• For this example we will put it in a churchcrm subdirectory under /var/www/html and expect to access this at: https://YourSiteName/churchcrm
• Run the following commands:
  • sudo mkdir /var/www/html/churchcrm
  • sudo unzip -d /var/www/html/churchcrm ChurchCRM-5.6.0.zip
  • sudo chown -R apache:apache /var/www/html/churchcrm