How to Install Roxy‑WI on Ubuntu
If you’re running a Linux web stack and want a slick admin dashboard without the bloat of other control panels, Roxy‑WI is worth a shot. Below are the hands‑on steps I use on fresh servers (Ubuntu 22.04 LTS) so you can get it up and running in minutes.
Steps to Get Roxy‑WI Running
Make Sure Your System Is Ready
sudo apt update && sudo apt upgrade -y sudo apt install curl gnupg2 ca-certificates lsb-release -y
The installer pulls data from an external repo, so you need a working network stack and the tools to verify signatures. If your server is behind a proxy, set http_proxy before running these commands.
Add Roxy‑WI’s Signing Key
curl -fsSL https://repo.roxy-wi.com/roxy-wi.key | sudo gpg --dearmor -o /usr/share/keyrings/roxy-wi-archive-keyring.gpg
The key prevents “untrusted source” warnings and protects you from rogue packages. I’ve seen servers get stuck on a broken apt-key command; this modern approach sidesteps that.
Register the Roxy‑WI Repository
echo "deb [signed-by=/usr/share/keyrings/roxy-wi-archive-keyring.gpg] https://repo.roxy-wi.com/deb $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/roxy-wi.list > /dev/null
Why this line? It tells APT exactly where to look for Roxy‑WI and ensures the package comes from the proper Ubuntu codename (focal, jammy, etc.). If you forget the signed-by part, you’ll get a “no signature” error.
Install the Package
sudo apt update sudo apt install roxy-wi -y
The installer pulls Apache, Nginx, PHP‑CLI, and all helper scripts in one go. Roxy‑WI will also set up a systemd service that starts automatically.
Finish the Setup Through the Web UI
Open your browser to http://your-server-ip:8080. The first screen is the wizard. Pick “Apache” or “Nginx,” choose an admin password, and let it finish configuring the web server. Once you’re logged in, you can start tweaking virtual hosts, SSL certificates, and more.
Common Pitfalls and Fixes
- GPG error: no public key
If apt update complains about a missing key, double‑check that the file path in step 5.3 matches the one you created in 5.2. Running the curl command again usually fixes it.
- 404 on the repo URL
Make sure your /etc/apt/sources.list.d/roxy-wi.list contains the correct Ubuntu codename ($(lsb_release -cs)). On a non‑standard release you’ll need to edit that line manually.
- Roxy‑WI service won’t start
Run sudo systemctl status roxy-wi.service. If it fails, the most common cause is missing PHP modules. Install them with:
sudo apt install php-cli php-mbstring php-xml php-curl php-gd -y
Optional: Disable Unused Web Servers
If you only want Apache and Roxy‑WI, you can purge Nginx to free up ports:
sudo apt remove nginx nginx-full -y
This is handy on servers that previously had a misconfigured Nginx instance.
That’s it! You now have a polished web interface for managing your Ubuntu server. Dive in, explore the dashboards, and enjoy a cleaner workflow than editing raw config files by hand.