OS Configuration

15 mins V7 Pro V6 Core

This doc will help you get the base OS for rConfig7 installed. If you are experienced in LAMP stack installation, or require your own OS customization and software head to the requirements section, and make sure you meet those requirements before installing rConfig v7. If not, read on - we provide scripts at the end of this doc to make the OS setup and build process 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.

Note

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

Tip

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

Videos

System Requirements

OS Version support

rConfig instances that are directly internet connected 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 Version support

Currently rConfig is supported on Rocky Linux /CentOS/ RHEL versions 9. Ubuntu 20.04+ and Alma Linux distros are also supported. Also, as CentOS becomes less favorable due to the recent changes to the OS, we will be moving to Rocky Linux as our preferred distro. We may still have references to CentOS in our documentation. Rocky and CentOS are used interchangeably.

General	Minimum Requirements
CPU/ Memory	64-bit x86 or ARM System (min 2 cores) 4GB+ RAM
Storage	100GB+
Operating System	CentOS 9 RHEL 9 Rocky Linux 9 (preferred) Ubuntu 20.04+ Alma Linux 9+
Web Server	Apache 2.4+
Database Server	MySQL 5.6.47+ MariaDB 11.0+
PHP Version	8.2 + (strictly)
Redis	6+
Other	Supervisord, Cron, NTP, Zip, ‘Development Tools’, disable SELinux
Firewall Ports	80/ 443 inbound. SSH and Telnet outbound 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 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

⚠ WARNING: OS Build requirementt

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.

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

We ask that you install a “Minimal” version of the OS if possible. For versions 8 & 9, you must specify that your require a “Minimal” installation during the setup. Select ‘“Software Selection” during setup and complete this step. See screenshot below for more information on this.

Ok, that was the hard part. Unless your want to install rConfig manually, its all scripted from here on out. Enjoy the flashing of rapid automation before your eyes!

Setup Script

Copy the code block below that aligns to your OS. The scripts below can be used to setup the base OS dependencies for rConfig Core and Pro.

Open your SSH console to your server, login as root, and paste the contents of your clipboard (The server may reboot initially, which will require you to log back in and run the script a second time - this is normal). Sit back, and relax. It may take a few minutes depending on Internet speeds and such nuances to set everything up. Watch out for any errors and report them if you get any.

WARNING: DB Password requirement

Avoid using some special characters in your database password, ( ! ” # $ % & ’), as the install scripts will not work.

Setup scripts by OS type

CentOS /Rocky

CentOS / Rocky Linux Scripts

The CentOS and Rocky Linux scripts are identical.

CentOS/Rocky 9 Setup Scripts

cd /home
yum -y install wget
wget https://www.rconfig.com/downloads/rconfig7_centos9.sh -O /home/install.sh
chmod +x install.sh
./install.sh

RHEL

RHEL 9 Setup Scripts

cd /home
yum -y install wget
wget https://www.rconfig.com/downloads/rconfig7_rhel9.sh -O /home/install.sh
chmod +x install.sh
./install.sh

Alma

ALMA Linux 9 Setup Scripts

cd /home
yum -y install wget
wget https://www.rconfig.com/downloads/rconfig7_alma.sh -O /home/install.sh
chmod +x install.sh
./install.sh

Ubuntu Scripts

Ubuntu 20.04+ Scripts

cd ~/
sudo apt -y install wget
wget https://www.rconfig.com/downloads/rconfig7_ubuntu.sh -O install.sh
chmod +x install.sh
sudo ./install.sh

Once all steps are completed record your database password some where safe, and reboot the server. Move on to the next step.