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:
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
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: