Skip to content

rConfig - V7 Pro Installation

15 mins V7 Pro

This is the main installation guide rConfig V7 Professional on all Distros. See last section on this page for specific Ubuntu Installation steps.


Complete the rConfig Professional installation by following three steps. Please run all steps as root

  1. Seutp a new MySql or MariaDb User account
  2. Download the deployer script
  3. First run Initialization of the deployer script
  4. Deploy rConfig and verify installation

Install steps per OS type


Setup a MariaDB/ MYSQL User

Ubuntu users will need to create a new user and password for the database. Login to the MariaDB/Mysql Database server using the root user. The root user password is the same as the one you used in the OS install script.

Terminal window
sudo mariadb -u root -p

Create the user and password for the database. And example is below, but you will need to change the username/password to something more secure.

Terminal window
GRANT ALL PRIVILEGES ON *.* TO 'user1'@localhost IDENTIFIED BY 'password1';
FLUSH PRIVILEGES;
quit;

Download the deployer script

Terminal window
mkdir /var/www/html/rconfig7
cd /var/www/html/rconfig7
wget https://www.rconfig.com/downloads/rconfig7-envoy.blade.php -O /var/www/html/rconfig7/Envoy.blade.php

First run Initialization of the deployer script

You need to have the follow details ready before you run the next command.

  • Database host name - ‘localhost’ if you followed all the instructions to this point
  • Database user name - ‘root’ unless you specify otherwise
  • Database password - per the previous steps in OS Setup
  • Hostname - The DNS Hostname for your machine, please create one if you do not have one already prepared
  • API Token - This can be retrieved from the license keys section rConfig.com portal (remove the angel brackets < >)

Once you have the above details, run the following command to initialize the rConfig installation.

Terminal window
envoy run init --dbhost=localhost --dbuser=root --dbpass=SomePassword --hostname=rconfig7vm.domain.local --apitoken=<someCode>

Note: We use Laravel Envoy as the deployment tool. If the envoy command fails for any reasons, first check that your system does not have https://www.getenvoy.io/ installed. You can check this by running the following;

Terminal window
[root@homedev html]# which envoy
/root/.composer/vendor/bin/envoy

Anything other than /root/.composer/vendor/bin/envoy returned and you need to uninstall the ‘other’ envoy, or update the environment variable to the correct Laravel Envoy path.

Deploy rConfig and verify installation

Next, run the following command to deploy rConfig.

Terminal window
envoy run deploy --apitoken=<someCode>

Once the process has completed without errors you may login to the server IP address or hostname with the following credentials

Username: [email protected] Password: admin

Once this process has completed without errors you may login to the server IP address or hostname with the following credentials

Username: [email protected] Password: admin