Getting started with XenoPanel

Save a server’s admin connection, add the server and provision it, then add a client and their first site.

5-minute read Applies to XenoPanel 1.0.0 Updated

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

Terminal
$ xenopanel init  # XenoPanel's folders on this Mac
$ xenopanel ssh setup web-1 --host 203.0.113.10

web-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

Terminal
$ xenopanel server add web-1

XenoPanel 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

Terminal
$ xenopanel server provision web-1 --dry-run  # the plan; changes nothing
$ xenopanel server provision web-1

Provisioning:

  • 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

Terminal
$ xenopanel client add acme
$ xenopanel client key add acme --key ~/Downloads/acme.pub
$ xenopanel site add example.com --client acme

A 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-1 shows 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.

Questions about XenoPanel?

Check the help pages first, or send us a message and we’ll get back to you within 24 hours.

Need help with an app or a license? Open a support ticket →

We reply within 24 hours on business days.