rConfig V8 Core Operating System Setup and Configuration Guide

rConfig V8 Core OS Installation & Setup

This guide shows how to set up the base operating system for rConfig V8 Core. It works for 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.

Video Tutorial

Administrative Responsibility

While our automated setup scripts help with installation, you are still responsible for managing and maintaining your server. This includes security updates, regular maintenance, and following your company’s security policies.

Make sure all systems meet your organization’s standards and any legal or regulatory requirements. For more details, see the rConfig Terms of Service.

Tip

You can watch video tutorials that show each step of the installation and setup process.

rConfig Youtube Channel.

System Requirements

Technical Specifications

The following components are required for proper rConfig V8 Core 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 (RHEL/ CENTOS/ ROCKY 10 not yet supported)
Web Server	Apache 2.4 or later
Database Server	MySQL 5.6.47+ • MariaDB 11.0+ • PostgreSQL 13+ (Enterprise edition only)
PHP Version	8.4 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. NOTE: A download KEY is NOT required for rConfig V8 Core installations.
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 CrownCloud 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 Core Professional 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.

MOve to Begin V8 Core Installation to continue with the installation process.

Next Steps:

• Review Security Hardening Guidelines
• Explore rConfig V8 Core Features and Roadmap
• Begin V8 Core Installation