rConfig - OS Configuration

15 mins V8 Pro V7 Pro V6 Core

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!

WARNING: You are responsible

We provide scripts at the end of this doc to make the OS setup and build process super easy! But you are responsible for server maintenance, patching and and security. Please ensure that the server, and application servers are up to date and patched inline with your corporate standards and security policies. See rConfig terms of service

for more information.

Tip

Please see our new video series for a visual walk through on the installation and setup process for rConfig.

Videos

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) CentOS 9 • RHEL 9 • Ubuntu 22.04+ • Alma Linux 9+ • AWS 2023
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 Outbound: SSH, Telnet (as required)

Other requirements

1. Setup your hostname in DNS and record it for use later
2. Get your API key from the rConfig portal - requires a subscription
3. DB Username and Password must be recorded for later use
4. Internet access for installations and upgrades (you can restrict to rConfigs public website IP address if required)

OS Internet Exposure

rConfig instances that are directly exposed to the internet are not supported. rConfig is a very secure and stable code base and platform, but such a utility has no business being directly accessible on public networks. Please ensure that your on-premise rConfig instance is behind a firewall, and only accessible via a VPN or other secure means. We do not provide rConfig as a cloud or SaaS offering at this time.

OS Setup

You have three steps to install the OS with the required software and dependencies for rConfig to run in a supported configuration.

1. Install the OS
2. Install the OS dependencies
3. Install rConfig - next page

OS Build requirement

Please use a fresh OS install, and do not use an OS deployment that is already used to host another application, webserver or any other function. rConfig is meant to be an appliance style deployment. Agent software such as Azure Agents, EndPoint Agent etc.. are supported but they may consume resources that rConfig needs to operate optimally. Please account for this in your planning.

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.

OS Software Selection

During setup, choose a Minimal installation of the OS whenever possible.
In the installer, go to Software Selection and select Minimal before continuing.
See the screenshot below for guidance.

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

Note: Please have a database username and password ready for use later.

1. Identify and copy the script that corresponds to your operating system.
   These scripts install the required base OS dependencies for rConfig Core and Pro.

2. Open an SSH session to your server and log in as the root user.

3. 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.

4. Allow the script to complete. Installation time will vary depending on your internet connection.

5. Monitor the output for any errors. If errors occur, document them and report accordingly.

Setup scripts by OS type

CentOS /Rocky

CentOS / Rocky Linux Scripts

The CentOS and Rocky Linux scripts are identical.

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 /home
yum -y install wget
wget https://dl.rconfig.com/downloads/rconfig8_centos9.sh -O /home/install.sh
chmod +x install.sh
./install.sh

RHEL

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 /home
yum -y install wget
wget https://dl.rconfig.com/downloads/rconfig8_rhel9.sh -O /home/install.sh
chmod +x install.sh
./install.sh

Alma

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 /home
yum -y install wget
wget https://dl.rconfig.com/downloads/rconfig8_alma.sh -O /home/install.sh
chmod +x install.sh
./install.sh

Ubuntu Scripts

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 wget
wget https://dl.rconfig.com/downloads/rconfig8_ubuntu.sh -O install.sh
chmod +x install.sh
sudo ./install.sh

AWS

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 wget
wget https://dl.rconfig.com/downloads/rconfig8_aws.sh -O install.sh
chmod +x install.sh
sudo ./install.sh

After completing all steps, securely record your database password for future reference.
Reboot the server, then proceed to the next step.

Video Tutorial