Installation - Install

Installation via RPM

To use the repository please make a donation to support the project via Boosty and we will send you the access credentials. Actual prices can be found here. Without voluntary contributions, we will not be able to carry out our work. Please donate as much as you can, every gift counts.

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:

For EL9 install extra packages for Ansible:

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, Impish, Jammy). 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:

Create Roxy-WI config file /var/www/haproxy-wi/app/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.

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:

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

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:

Digital Ocean (Roxy-WI 4.5.1)
Amazon Web Services (Roxy-WI 5.2.0)
G-Core Labs (Roxy-WI 4.5.1)
Vultr (Roxy-WI 5.2.0)

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 /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!

Not really

You may also be interested in:

Roxy-WI Docker image

Settings

How to update Roxy-WI

Name:
Surname:
Company:
E-mail: