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: AddingExtraRockyRepositories
• 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;