rConfig - OS Configuration
Introduction
Section titled “Introduction”This doc will help you get the base OS for rConfig V8 installed. This guide covers installation for V8 Pro, V7 Pro, and V6 Pro.
If you are experienced in LAMP stack installation
or want to customize your OS setup, skip ahead to the requirements.
If not, read on — we provide scripts to make setup and build super easy!
System Requirements
Section titled “System Requirements”System Requirements
All components below are required for rConfig8 to operate correctly:
Component | Requirements |
---|---|
CPU/Memory | 64-bit x86 or ARM System (min 2 cores) 4GB+ RAM |
Storage | 100GB+ |
Operating System | Rocky Linux 9 (preferred) |
Web Server | Apache 2.4+ |
Database Server | MySQL 5.6.47+ • MariaDB 11.0+ • PostgreSQL 13+ (Enterprise only) |
PHP Version | 8.4+ (strictly required) |
Redis | 6+ |
Additional Software | Supervisord, Cron, NTP, Zip, Development Tools Note: SELinux must be disabled |
Firewall Ports | Inbound: 80, 443 |
Other requirements
- Setup your hostname in DNS and record it for use later
- Get your API key from the rConfig portal - requires a subscription
- DB Username and Password must be recorded for later use
- Internet access for installations and upgrades (you can restrict to rConfigs public website IP address if required)
OS Setup
Section titled “OS Setup”You have three steps to install the OS with the required software and dependencies for rConfig to run in a supported configuration.
- Install the OS
- Install the OS dependencies
- Install rConfig - next page
OS Installation Steps
Section titled “OS Installation Steps”It is outside the scope of this document to guide you on how to install an operating system. Be it physical or virtual, the steps are much the same. There is an excellent document on linuxteck that has practically identical steps for both Rocky/CentOS or RHEL to install the OS.
Okay, that was the hard part. From here, everything is scripted unless you prefer to install rConfig manually.
Sit back and enjoy the rapid automation in action!
Setup Script
Section titled “Setup Script”Note: Please have a database username and password ready for use later.
-
Identify and copy the script that corresponds to your operating system.
These scripts install the required base OS dependencies for rConfig Core and Pro. -
Open an SSH session to your server and log in as the root user.
-
Paste the script into the console and execute it.
- The server may reboot during this process. If it does, log back in as root and run the script again. This behavior is expected.
-
Allow the script to complete. Installation time will vary depending on your internet connection.
-
Monitor the output for any errors. If errors occur, document them and report accordingly.
Setup scripts by OS type
Section titled “Setup scripts by OS type”CentOS / Rocky Linux Scripts
Section titled “CentOS / Rocky Linux Scripts”
The CentOS and Rocky Linux scripts are identical.
CentOS/Rocky 9 Setup Scripts
Section titled “CentOS/Rocky 9 Setup Scripts”Note: if the machine reboots during the script, log back in as root and run the script again. This behavior is expected.
cd /homeyum -y install wgetwget https://dl.rconfig.com/downloads/rconfig8_centos9.sh -O /home/install.shchmod +x install.sh./install.sh
RHEL 9 Setup Scripts
Section titled “RHEL 9 Setup Scripts”
Note: if the machine reboots during the script, log back in as root and run the script again. This behavior is expected.
cd /homeyum -y install wgetwget https://dl.rconfig.com/downloads/rconfig8_rhel9.sh -O /home/install.shchmod +x install.sh./install.sh
ALMA Linux 9 Setup Scripts
Section titled “ALMA Linux 9 Setup Scripts”
Note: if the machine reboots during the script, log back in as root and run the script again. This behavior is expected.
cd /homeyum -y install wgetwget https://dl.rconfig.com/downloads/rconfig8_alma.sh -O /home/install.shchmod +x install.sh./install.sh
Ubuntu 20.04+ Scripts
Section titled “Ubuntu 20.04+ Scripts”
Note: if the machine reboots during the script, log back in as root and run the script again. This behavior is expected.
cd ~/sudo apt -y install wgetwget https://dl.rconfig.com/downloads/rconfig8_ubuntu.sh -O install.shchmod +x install.shsudo ./install.sh
AWS Linux 2023 Scripts
Section titled “AWS Linux 2023 Scripts”Note: if the machine reboots during the script, log back in as root and run the script again. This behavior is expected.
cd ~/sudo apt -y install wgetwget https://dl.rconfig.com/downloads/rconfig8_aws.sh -O install.shchmod +x install.shsudo ./install.sh
After completing all steps, securely record your database password for future reference.
Reboot the server, then proceed to the next step.