logo

Installation

OS support


Roxy-WI supports the following OSes: Go to TOP

Installation on CentOS/Red Hat Enterprise Linux/Amazon Linux 2/Oracle Linux



The information concerning the installation for different OSes can be found here. To install Roxy-WI on CentOS/Red Hat Enterprise Linux/Amazon Linux 2/Oracle Linux, perform the steps described below.

Retrieve the signed RPM configuration files (you should perform this command as sudo)

Install the extra repository:

Install Roxy-WI and the services:

Open in your browser the link: https://your_ip/

Default credentials: login - admin, password - admin

If you are going to use Roxy-WI to manage multiple servers in production, it is recommended to use MySQL. Read here how to set up MySQL.

Do not forget generate a new SALT. Read here how to do it.

Go to TOP

Installation on Ubuntu



DEB packages are available only on the following Linux distributions: Ubuntu (Bionic, Focal, Groovy, Hirsute, Impish, Jammy, Kinetic, Lunar, Mantic). The information concerning the installation for different OSes can be found here. Perform the steps below to install Roxy-WI on Ubuntu.

Add Roxy-WI repository to your source list:

Perform the following commands:

Install additional Python packages if not installed:

Create Roxy-WI config file in the directory /etc/roxy-wi/roxy-wi.cfg:

Open in your browser the link: https://your_ip/

Default credentials: login - admin, password - admin

If you see the "Internal error" after installation, install all requirements via pip3.

If you are going to use Roxy-WI to manage multiple servers in production, it is recommended to use MySQL. Read here how to set up MySQL.

Do not forget generate a new SALT. Read here how to do it.

Go to TOP

Manual installation

If you would like to install Roxy-WI manually, you should perform the following commands:

If you use Debian/Ubuntu:

Change httpd to apache2 PATH and apache to www-data user in all configs

Then create the database:
Disable SELinux.

Open in your browser the link: https://your_ip/

Default credentials: login - admin, password - admin

Do not forget generate a new SALT. Read here how to do it.

Go to TOP

Installing Ansible


If you install RPM or DEB packages, Ansible will be installed with Roxy-WI and configured automatically. For manual installation perform the following commands:
Go to TOP

Installing the SELinux policy

If you install RPM packages, the SELinux policy will be installed automatically. If you have problems with configuring the SELinux policy, install the following package:

Also you can simply disable SELinux.

Go to TOP

Fail2ban installation


If you install RPM or DEB packages, Fail2ban will be installed automatically. For manual installation perform the following command:

Read more about the Fail2ban service here.

Go to TOP

After the installation: Configuring Roxy-WI

Once you have installed Roxy-WI, you have to edit the configuration file /etc/roxy-wi/roxy-wi.cfg. The default configuration is shown below:

Database settings

Roxy-WI uses SQLite as the default database. If you would like to use MySQL, make the following changes in the configuration file:

Once you have edited the configuration file, create the database for Roxy-WI on your MySQL Server:

After creating the database run the script create_db.py. The script is in folder /var/www/haproxy-wi/app

If you are going to use Roxy-WI to manage multiple servers in production, it is recommended to use MySQL.

Go to TOP

Configuring Apache

If you would like to use a custom domain name, you should make changes in the Apache configuration file for Roxy-WI:

If you would like to enable the redirect from port 80 to port 443, add the following lines to your configuration file:

Find the following lines and replace "roxy-wi.example.com" with your domain name:

If you would like to use custom certificates, edit the following lines:

Go to TOP

Generate SALT

Since version 7.1.2 Roxy-WI starts crypte SSH passwords and SSH passphrases. To be ensured nobody can decrypt your passwords expect you, you should generate your own salt (run python3 for it) and put in to the /etc/roxy-wi/roxy-wi.cfg:

Go to TOP

Was this article helpful?

Yes, thanks!
Go back