Troubleshooting
On this page, you can find information about resolving known errors. However, if you need further assistance, please don't hesitate to create a new issue on GitHub.
Roxy-WI is constantly developing, and as a result, bugs may occur.
You are very welcome to report any bug on GitHub!
If you encounter an error, you should first refer to the logs. All logs are stored in the Admin area => Internal logs section.
Check the logs of the service where the error was detected (select the service from the drop-down list and click Show).
For more detailed information, refer to the Roxy-WI logs and the error log as well.
If you are unable to start a service and do not see any corresponding messages in the logs, first check the service's state:
systemctl status roxy-wi-service_name
For more information, you may also refer to the system logs: /var/log/messages (in CentOS) and /var/log/syslog (in Ubuntu).
If checking the logs does not help, try running the service manually:
cd /var/www/haproxy-wi/app ./service_name.py
If you encounter any errors while updating Roxy-WI through the web interface, try updating it via the command line:
For YUM:
yum clean all
yum update roxy-wi
For APT:
apt-get clean
apt-get update
apt-get install roxy-wi
If you see an Internal Server Error when launching Roxy-WI for the first time, open the Apache error log; it is likely that some modules are missing.
If that is the case, install the required modules from GitHub.
During the installation of Roxy-WI, you may encounter the following error:
Errors during downloading metadata for repository 'roxy-wi':
- Status code: 404 for https://login:password@repo.roxy-wi.org/$ostype8/repodata/repomd.xml (IP: 172.67.172.199)
Error: Failed to download metadata for repo 'roxy-wi': Cannot download repomd.xml: Cannot download repodata/repomd.xml: All mirrors were tried
To resolve this issue, open the /etc/yum.repos.d/roxy-wi.repo file and replace $ostype with el in the line that begins with $baseurl.
After the installation of Roxy-WI, you may encounter the following error:
FileNotFoundError: [Errno 2] No such file or directory: '/var/lib/roxy-wi/keys/roxy-wi-key'
To resolve the issue, run the SSH key generator:
ssh-keygen -t rsa -b 4096 -m pem -f /var/lib/roxy-wi/keys/roxy-wi-key -C "Roxy-WI JWT KEY. DO NOT DELETE IT!" -P ""
chown apache_user:apache_user -R /var/lib/roxy-wi/
systemctl reload apache_service