XenoPanel sets up and maintains Ubuntu web servers from your Mac, over SSH. Nothing of its own runs on the server: no agent, no web panel and no extra open ports. This article uses the xenopanel command; the app runs the same commands.
Before you start
You’ll need:
- a Mac with Apple silicon, on macOS 15 or later
- a fresh Ubuntu 24.04 or 26.04 LTS server from any provider, without Apache, MySQL or MariaDB installed
- the server’s address, and its root login or the first user your provider gives you
Save the admin connection
$ xenopanel init # XenoPanel's folders on this Mac
$ xenopanel ssh setup web-1 --host 203.0.113.10web-1 is the name you give the server on this Mac. The wizard makes a key for this server alone, saves a connection named xenopanel-web-1 in ~/.ssh/config, checks the server’s host key and copies the key to the server. The only password it asks for is the server’s, once, typed into ssh itself. Add --user if your provider’s first login isn’t root, and --port if SSH isn’t on port 22.
Add the server
$ xenopanel server add web-1XenoPanel reads the server once (its Ubuntu release, sudo, services and any records in /etc/xenopanel) and remembers it. Nothing on the server changes. xenopanel server check web-1 reads it again at any time.
Provision it
$ xenopanel server provision web-1 --dry-run # the plan; changes nothing
$ xenopanel server provision web-1Provisioning:
- creates the admin account
xpadmin, with key login and passwordless sudo, and moves the connection to it - turns off root and password logins, and lets in only SSH, 80 and 443
- adds fail2ban, security updates that install themselves without rebooting, and swap on small servers
- installs nginx, MySQL 8.4 and Composer
Each step is checked, and a step that fails is rolled back. Running it again changes nothing on a server that’s already provisioned. The server’s time zone is UTC unless you add --time-zone, for example --time-zone Europe/Amsterdam.
Add a client and a site
$ xenopanel client add acme
$ xenopanel client key add acme --key ~/Downloads/acme.pub
$ xenopanel site add example.com --client acmeA client is a Linux user who holds one or more sites. Clients log in with SSH keys only, and reach only their own sites.
site add installs the site’s PHP (the newest 8.5 unless you choose another with --php), its own PHP-FPM service, its folders in /home/acme/htdocs/example.com/ and its nginx vhost. The site serves its public folder; choose another with --web-root. Add --cloudflare to create its DNS records and install a Cloudflare Origin certificate as well, as Cloudflare explains. Without it, the site gets a self-signed certificate.
Keep going
xenopanel server status web-1shows what the server still needs, from this Mac’s records.- Clients, sites and PHP covers PHP versions and settings, and turning sites and clients off.
- Databases adds MySQL databases and their users.
- Server updates keeps the server up to date.