rConfig V8 Operating System Setup and Configuration Guide

rConfig V8 Operating System Setup and Configuration Guide

Operating System Configuration Overview

This document provides comprehensive guidance for configuring the base operating system for rConfig V8 deployment. These instructions apply to both V8 Pro and Vector Server installations.

For administrators experienced with LAMP stack deployments or those requiring custom OS configurations, please refer directly to the system requirements. Otherwise, we recommend utilizing our automated setup scripts for streamlined deployment.

Administrative Responsibility

While automated setup scripts are provided to streamline deployment, system administrators remain fully responsible for ongoing server maintenance, security patching, and compliance with organizational security policies. Ensure all server components are maintained according to enterprise standards and regulatory requirements. Refer to the rConfig Terms of Service for additional information.

Tip

Supplementary video tutorials are available to provide visual guidance throughout the installation and configuration process.

View Video Series

System Requirements

Technical Specifications

The following components are required for proper rConfig V8 operation:

Component	Specification
CPU/Memory	64-bit x86 or ARM architecture (minimum 2 cores) 4GB RAM minimum
Storage	100GB minimum
Operating System	Rocky Linux 9 (recommended) CentOS 9 • RHEL 9 • Ubuntu 22.04+ • Alma Linux 9+ • AWS Linux 2023
Web Server	Apache 2.4 or later
Database Server	MySQL 5.6.47+ • MariaDB 11.0+ • PostgreSQL 13+ (Enterprise edition only)
PHP Version	8.3 or later (mandatory)
Redis	Version 6 or later
Additional Requirements	Supervisord, Cron, NTP, Zip, Development Tools Important: SELinux must be disabled
Network Ports	Inbound: 80 (HTTP), 443 (HTTPS) Outbound: SSH, Telnet (as required by environment)

Additional Prerequisites

1. Configure and register the server hostname in DNS for future reference
2. Obtain your Download API key from the rConfig portal (active subscription required)
3. Document database credentials (username and password) for configuration steps
4. Ensure internet connectivity for installation and updates (optionally restricted to rConfig’s public IP addresses)
5. Docker is optional on the base OS but required for specific Pro features, including XFTP Services Note: XFTP services cannot operate within containerized rConfig deployments, as these services are themselves containerized

Network Security Requirements

Direct internet exposure of rConfig instances is not supported. While rConfig maintains a secure and stable codebase, network configuration management platforms should never be directly accessible from public networks. Ensure all on-premise rConfig deployments are protected by appropriate firewall configurations and accessible only via VPN or equivalent secure access methods. rConfig is not currently offered as a cloud-hosted or SaaS solution.

Deployment Overview

The operating system deployment process consists of three primary phases:

1. Base OS Installation
2. Dependency Installation
3. rConfig Installation (covered in the next section)

Deployment Environment Requirements

Deploy rConfig on a dedicated operating system installation. Do not deploy on systems currently hosting other applications, web servers, or services. rConfig is designed as an appliance-style deployment. While endpoint management agents (e.g., Azure Agents, monitoring tools) are supported, they may consume resources required for optimal rConfig performance. Account for these requirements during capacity planning.

OS Installation Steps

Detailed operating system installation procedures are beyond the scope of this documentation. Installation processes are consistent across physical and virtual environments. For comprehensive installation guidance, refer to the Linux Teck installation guide, which provides applicable procedures for Rocky Linux, CentOS, and RHEL distributions.

Installation Profile Selection

During OS installation, select a Minimal installation profile when available.
Navigate to Software Selection in the installer and choose Minimal before proceeding.
Refer to the screenshot below for visual guidance.

Following successful OS installation, proceed with automated dependency installation using the provided scripts. Manual installation procedures are available for administrators requiring custom configurations. After completing OS configuration, continue with rConfig V8 Professional Installation or rConfig Vector Server Installation depending on your deployment requirements.

Automated Setup Script

Prerequisites: Prepare database credentials (username and password) before proceeding.

Deployment Procedure:

1. Select and copy the appropriate setup script for your operating system distribution from the sections below.
   These scripts install all required dependencies for rConfig Core and Pro editions.

2. Establish an SSH session to the target server and authenticate as the root user.

3. Execute the selected script in the terminal.

   • The system may reboot during this process. If a reboot occurs, re-authenticate as root and re-execute the script. This behavior is expected.

4. Monitor the installation process to completion. Duration varies based on network connectivity.

5. Review the output for any error messages. Document and report any issues encountered.

Distribution-Specific Setup Scripts

CentOS /Rocky

CentOS / Rocky Linux

The following script is compatible with both CentOS and Rocky Linux distributions.

CentOS/Rocky 9 Setup Script

Note: System reboot during script execution is expected. Re-authenticate as root and re-execute the script following any reboot.

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

Red Hat Enterprise Linux 9

Note: System reboot during script execution is expected. Re-authenticate as root and re-execute the script following any reboot.

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

AlmaLinux 9

Note: System reboot during script execution is expected. Re-authenticate as root and re-execute the script following any reboot.

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 22.04 and Later

Note: System reboot during script execution is expected. Re-authenticate as root and re-execute the script following any reboot.

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

Amazon Linux 2023

Note: System reboot during script execution is expected. Re-authenticate as root and re-execute the script following any reboot.

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

Upon completion of all configuration steps, securely document your database credentials for future reference.
Perform a system reboot before proceeding to the rConfig installation phase.

Next Steps:

• Review Security Hardening Guidelines
• Explore rConfig V8 Features and Roadmap
• Begin V8 Professional Installation
• Install rConfig Vector Server

Video Tutorial