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
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
Installation on Ubuntu
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:
Manual installation
If you would like to install Roxy-WI manually, you should perform the following commands:
Change httpd to apache2 PATH and apache to www-data user in all configs
Then create the database:
Roxy-WI will be available at the following address: https://your_ip/. The login and the password used by default are: admin/admin
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:
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:
Installing Fail2ban
If you install RPM or DEB packages, Fail2ban will be installed automatically. For manual installation perform the following command:
Read more about Fail2ban service The Fail2ban service description
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.
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.
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:
