Install Ilexarium

From a Linux machine you already run to the Ilexarium setup page, in about ten minutes.

Ilexarium installs onto a Linux machine you already have — an old laptop, a mini PC, a server in the cupboard. It doesn't replace the system; it adds a web interface on top and installs the programs it needs.

What you need

  • A supported system: Debian 12 or 13, Ubuntu 26.04 (24.04 with Borg 1.4 installed first) or Arch Linux, on an amd64 or arm64 machine.
  • An account with sudo on that machine. Ilexarium acts as this account: whatever you do in Ilexarium, you do as yourself.

1. Download the installer and read it

curl -fsSL https://ilexarium.com/get-ilex.sh -o get-ilex.sh
less get-ilex.sh

It's a short script. It downloads the newest release, checks its signature with the public key written inside the script, checks the archive's size and fingerprint, and only then unpacks and runs the installer.

Check that its key line is exactly this one, the key that signs every Ilexarium release:

PUBLIC_KEY='RWTCTN0pOPdJ/mpJjRirU77qRxeSGPL7lzj5u5xSeDlZSvyd+AU+1QVg'

2. Run it

bash get-ilex.sh

The installer lists the programs that are missing and asks before installing any of them. It asks for your password through sudo — Ilexarium itself never keeps it. Running it again later is safe: every step checks first and changes only what's missing.

One change to know about: it lets SSH accept password sign-ins from the machine itself only (/etc/ssh/sshd_config.d/ilex.conf). Ilexarium's files and terminal sign in to your account that way. Connections from anywhere else keep your SSH settings as they are.

It also asks whether to open Ilexarium from other devices. Say yes (the default) to use it from your laptop or phone at home: it then listens on your network on port 3443, over HTTPS with a certificate of its own. Say no (or install with bash get-ilex.sh --local-only) if only an HTTPS proxy on the machine should reach it.

At the end it prints the address to open, the certificate's fingerprint and a link to the setup page.

3. Open it and check the certificate

Open the setup link from the end of the installation, https://<your server's address>:3443/setup#token=…, on any device on your network. Your browser warns you once: the certificate is your server's own (self-signed), so the browser can't check it. Before you go on, open the certificate's details in the warning and compare its SHA-256 fingerprint with the one the installer printed. If they match, it's your server; go on.

If a firewall (ufw, firewalld) is on, the installer says so: allow port 3443 there first. Never forward port 3443 on your router.

HTTPS in front, if you like: with your own domain or a private network that gives you a real certificate, the browser won't warn at all. A reverse proxy such as Caddy or nginx on the same machine uses 127.0.0.1:3000; see HTTPS in front of Ilexarium. Away from home: Reach your server from outside.

4. Create your account

Create the owner account on the setup page. Lost the link? Print it again on the machine:

sudo ilex-setup-code

That's it. From here on, Ilexarium updates itself from signed releases when you choose to.