logo

Installation

This guide describes installation on options for Roxy-WI:

Installation via RPM



RPM packages are available only on the following Linux distributions: 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 via RPM, 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:

Open in your browser: https://your_ip/ Default login/password are: admin/admin

Go to TOP

Installation via DEB



DEB packages are available only on the following Linux distributions: Ubuntu(Bionic, Focal, Groovy, Hirsute). The information concerning the installation for different OSes can be found here. To install Roxy-WI via DEB, perform the steps described below.

Add Roxy-WI repository to your source list:

Create a new file /etc/apt/auth.conf.d/roxy-wi.conf with your credentials:

Perform the following commands:

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.

Roxy-WI will be available at the following address: https://your_ip/. The login and the password used by default are: admin/admin

Go to TOP

Installing Ansible


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

Installing the SELinux policy

If you perform the installation via RPM, the SELinux policy will be installed automatically together with Roxy-WI. If you have problems with configuring the SELinux policy, install the following package:

Also you can simply disable SELinux.

Go to TOP

Installing Fail2ban


If you perform the installation via RPM, Fail2ban will be installed automatically together with Roxy-WI. For manual installation perform the following command:

Read more about Fail2ban service The Fail2ban service description

Go to TOP

OS support


Roxy-WI supports the following OSes: Go to TOP

Ready-made Virtual Servers

You can create a virtual server on which Roxy-WI is already installed at the following cloud service providers:

The interface for creating a virtual server is intuitive. There is an instruction on the MarketPlace page of each provider.


Go to TOP

After the installation: Configuring Roxy-WI

Once you have installed Roxy-WI, you have to edit the configuration file $HOME_HAPROXY-WI/app/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:

Configuring Apache

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

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

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

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

Was this article helpful?

Yes, thanks!
Not really
Go back