Installation Install

OS support

Roxy-WI supports the following OSes:

EL7 (RPM installation and manual installation). It must be "Infrastructure Server" at least. x86_64 only.
EL8 (RPM installation and manual installation). It must be "Infrastructure Server" at least. x86_64 only.
EL9 (RPM installation and manual installation). It must be "Infrastructure Server" at least. x86_64 only.
Amazon Linux 2 (RPM installation and manual installation). x86_64 only.
Ubuntu (DEB installation and manual installation). x86_64 only.
Other Linux distributions (manual installation only). x86_64 only.

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

In order to use the repository please make a donation to support our project on Boosty. We will send you the access credentials by email shortly. Actual prices can be found here. Without voluntary contributions we will not be able to carry out our work. Any donations to support our work are very welcome - every gift counts!

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

In order to use the repository please make a donation to support our project on Boosty. We will send you the access credentials by email shortly. Actual prices can be found here. Without voluntary contributions we will not be able to carry out our work. Any donations to support our work are very welcome - every gift counts!

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!

Name:
Surname:
Company:
E-mail:

Installation

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

Default credentials: login - admin, password - admin

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

Default credentials: login - admin, password - admin

Was this article helpful?

You may also be interested in: