Skip to content

rConfig - V7 Pro to V8 Pro: Upgrade Guide

15 mins V8 Pro V7 Pro

Upgrading from rConfig V7 Pro to V8 Pro is quick and straightforward. We’ve provided a fully automated script to handle all the required steps for CentOS, RHEL, Rocky Linux, and Ubuntu-based systems.

Upgrade Procedure

Section titled “Upgrade Procedure”
Terminal window
cd /home
wget https://dl.rconfig.com/downloads/upgrade-to-rconfig8.sh -O upgrade-to-v8.sh
chmod +x upgrade-to-v8.sh
sudo ./upgrade-to-v8.sh YourSecureToken1234 v8

🔧 Final Step – Update Database Paths

Section titled “🔧 Final Step – Update Database Paths”

Once the upgrade script completes, update any legacy paths in the database that refer to rconfig5, rconfig6, or rconfig7 directories:

Terminal window
cd /var/www/html/rconfig8/current
php artisan rconfig:updatedb8

Web Server Configuration

Section titled “Web Server Configuration”

For Apache, ensure your DocumentRoot points to /var/www/html/rconfig8/current/public. For Nginx, update the root directive accordingly.

First check your config files:

Terminal window
# Apache Ubuntu
apache2ctl -S


# Apache RHEL/CentOS/Rocky
httpd -S


# Example output:
VirtualHost configuration. Check each VirtualHost for proper updated path:
10.1.1.2:443           vega.rconfig.com (/etc/httpd/sites-enabled/vega.rconfig.com-le-ssl.conf:3)
*:443                  vega.rconfig.com (/etc/httpd/conf.d/ssl.conf:40)
*:80                   vega.rconfig.com (/etc/httpd/sites-enabled/vega.rconfig.com.conf:2)

For each virtual host, update the DocumentRoot:

# Change rconfig7 to rconfig8


RewriteRule ^ https://%{SERVER_NAME}%{REQUEST_URI} [END,NE,R=permanent]
<IfModule mod_ssl.c>
<VirtualHost v8demo.rconfig.com:443>
        ServerName v8demo.rconfig.com
        ServerAlias v8demo.rconfig.com
        DocumentRoot /var/www/html/rconfig8/public
        <Directory "/var/www/html/rconfig8/public">
                Options Indexes FollowSymLinks MultiViews
                Order allow,deny
                Allow from all
                AllowOverride All
                Require all granted
                Satisfy Any
        </Directory>


    SSLEngine on
    SSLCertificateFile  /etc/pki/tls/certs/cert.crt
    SSLCertificateKeyFile /etc/pki/tls/private/key.key


    SSLProtocol             all -SSLv3 -TLSv1 -TLSv1.1
    SSLCipherSuite          PROFILE=SYSTEM


</VirtualHost>
</IfModule>

🎉 That’s it!

Section titled “🎉 That’s it!”
  • Your rConfig system is now running V8 Pro
  • You can log in at your existing rConfig URL
  • Make sure to hard-refresh the browser (CTRL+SHIFT+R) after the upgrade
rConfig V8 Login Page