haproxy-wi/README.md

Web interface(user-friendly web GUI, alerting, monitoring and secure) for managing HAProxy, Nginx and Keepalived servers. Leave your feedback

Get involved

• Youtube Demo video
• Twitter, subscribe!
• Telegram Channel about Roxy-WI, talks and questions are welcome

Demo site

Demo site Login/password: admin/admin. Server resets every hour.

Features:

1. Installation and updating HAProxy, Nginx and Keepalived with Roxy-WI
2. Installation and updating Grafana, Prometheus servers with Roxy-WI
3. Installation and updating HAProxy and Nginx exporters with Roxy-WI
4. Server provisioning on AWS, DigitalOcean and G-Core Labs
5. Downloading, updating and formatting GeoIP to the acceptable format for HAProxy with Roxy-WI
6. Dynamic change of Maxconn, Black/white lists and backend's IP address and port with saving changes to the config file
7. Configuring HAProxy, Nginx and Keepalived in a jiffy with Roxy-WI
8. Viewing and analysing the status of all Frontend/backend servers via Roxy-WI from a single control panel
9. Enabling/disabling servers through stats page without rebooting HAProxy
10. Viewing/Analysing HAProxy and Nginx logs right from the Roxy-WI web interface
11. Creating and visualizing the HAProxy workflow from Web Ui
12. Pushing Your changes to your HAProxy, Nginx and Keepalived servers with a single click via the web interface
13. Getting info on past changes, evaluating your config files and restoring the previous stable config at any time with a single click right from Web interface
14. Adding/Editing Frontend or backend servers via the web interface with a click
15. Editing the config of HAProxy, Nginx and Keepalived and push ingchanges to All Master/Slave servers by a single click
16. Adding Multiple server to ensure the Config Sync between servers
17. Managing the ports assigned to Frontend automatically
18. Evaluating the changes of recent configs pushed to HAProxy, Nginx and Keepalived instances right from the Web UI
19. Multiple User Roles support for privileged based Viewing and editing of Config
20. Creating Groups and adding/removing servers to ensure the proper identification for your HAProxy and Nginx Clusters
21. Sending notifications from Roxy-WI via Telegram, Slack and via the web interface
22. Supporting high Availability to ensure uptime to all Master slave servers configured
23. Support of SSL (including Let's Encrypt)
24. Support of SSH Key for managing multiple HAProxy and Nginx Servers straight from Roxy-WI
25. SYN flood protect
26. Alerting about сhanges of the state of HAProxy backends
27. Alerting about the state of HAProxy and Nginx service
28. Gathering metrics for incoming connections
29. Web acceleration settings
30. Firewall for web application
31. LDAP support
32. Keep active HAProxy and Nginx services
33. Possibility to hide parts of the config with tags for users with "guest" role: "HideBlockStart" and "HideBlockEnd"
34. Mobile-ready design
35. Simple port monitoring (SMON)
36. Backup HAProxy, Nginx and Keepalived config files through Roxy-WI
37. Managing OpenVPN3 as a client via Roxy-WI

Install

RPM

Read instruction on the official site

Manual install

Read instruction on the official site

OS support

Roxy-Wi was tested on EL7, EL8 and all scripts too. Debian/Ubuntu OS support at 'beta' stage, may work not correct

Database support

Default Roxy-WI use Sqlite, if you want use MySQL enable in config, and create database:

For MySQL support:

Read instruction on the official site

Settings

Login https://roxy-wi-server/users.py, and add: users, groups and servers. Default: admin/admin

Read instruction on the official site

Troubleshooting

If you have error:

Forbidden
You don't have permission to access /app/overview.py on this server. 

Check owner(must be apache, or another user for apache)

If at first login you have:

Internal Server Error

Do this:

$ cd /var/www/haproxy-wi/app
$ ./create_db.py

and check executeble py files

If you see plain text, check section "Directory" in httpd conf