General info

Below you will find the recommendations for error identification and the description of the possible ways of resolving the most common errors.


If you encounter an error, you should refer to the logs first. It is necessary to define the possible cause and the circumstances of the error. All logs are stored in the Internal logs section. Begin with the logs of the service in which the error has been detected. For more detailed information refer to the logs of Roxy-WI and to the error log as well.

Apache Error Log

Go to TOP

"Cannot update version" message when logging in

If you cannot log in and see the "Cannot update message" message in the right upper corner of the page, you must have a problem with the database owner. This error occurs if the database was created manually and the correct owner was not changed. To resolve it, set the correct database owner: apache (in CentOS) or www-date (in Debian and Ubuntu).

Bad DB owner

Go to TOP

Errors that occur during the installation

When you cannot install HAProxy, Nginx, or Keepalived) and no error is displayed in the logs, try to run the installation via the web interface and perform the following command in your terminal: ps ax|grep bash In the output you should see the line containing the name of the script "installation_serviceName.sh". Copy it and perform the following commands:

Paste the command you copied and see where the problem occurs.

Go to TOP

Errors that occur when starting Roxy-WI services

If you cannot start a service and find no corresponding messages in the logs, try to check its state first: systemctl status roxy-wi-service_name For more information you may also refer to the system logs: /var/logs/message (in CentOS) and /var/log/syslog (in Ubuntu)

If referring to the logs does not help, try to run the service manually:

Go to TOP

Errors that occur when updating Roxy-WI

If any errors occur when updating Roxy-WI via the web interface, try to update it via the command line:

Go to TOP

Internal server error during the first start

If you see the Internal server error when launching Roxy-WI for the first time, go to the /var/www/haproxy-wi/app directory and check whether the execution of all *.py files is allowed.

Go to TOP

Error that occurs during the installation via Ansible

During the installation via Ansible you may encounter the following error:

This a known Ansible bug. To resolve it update Ansible to version 2.9.8 or newer.

You may also receive the following error message during the installation via Ansible:

This is a known of the Nginx official repository, and it must be resolved soon. Now the only possible solution is to update Ansible at least to version 2.12.

On some Ubuntu installation could be:

It would appear because there is no needed package:

Go to TOP

Error when downloading metadata in course of installation

In course of installation of Roxy-WI you may encounter the following error:

To resolve this problem, open the /etc/yum.repo.d/roxy-wi.repo file and replace $ostype to el in the line beginning with $baseurl.

Go to TOP

Was this article helpful?

Yes, thanks!
Not really
Go back