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)

Open the following file:

Add your credentials:

Install the extra repository:

Install Roxy-WI and the services:

For EL9 install extra packages for Ansible:

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

Default credentials: login - admin, password - admin

Go to TOP

Installation on Ubuntu



DEB packages are available only on the following Linux distributions: Ubuntu (Bionic, Focal, Groovy, Hirsute, Impish, Jammy). 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:

Create a new text file in the directory /etc/apt/auth.conf.d/roxy-wi.conf and write down your credentials in it:

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:

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

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

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

Was this article helpful?

Yes, thanks!
Go back