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 the link: https://your_ip/
Default credentials: login - admin, password - admin
Installation 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:
Open in your browser the link: https://your_ip/
Default credentials: login - admin, password - admin
If you see the "Internal error" after installation, install all requirements via pip3.
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:
Open in your browser the link: https://your_ip/
Default credentials: login - admin, password - 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:
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.
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. The script is in folder /var/www/haproxy-wi/app
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:
Generate SALT
Since version 7.1.2 Roxy-WI starts crypte SSH passwords and SSH passphrases. To be ensured nobody can decrypt your passwords expect you, you should generate your own salt (run python3 for it) and put in to the /etc/roxy-wi/roxy-wi.cfg: