Install on Ubuntu

On a mini-PC or server, one command installs Docker, Tailscale, Avahi and every Élise component, including the TV screen, Chromium, Jitsi and camera and microphone permissions.

Requirements

• Ubuntu Server 24.04 LTS, AMD64 or ARM64.
• 8 GB of memory recommended (4 GB minimum), 32 GB of storage with 16 GB free.
• Ports 8080, 18080 and 8555 free.
• Internet access and sudo.

Install

curl -fsSL https://github.com/Elise-OS/EliseOS/releases/latest/download/install-elise.sh | sudo bash

The installer:

1. checks the machine (system, architecture, memory, disk, ports);
2. installs Docker, Tailscale, Avahi and the required tools;
3. downloads the release manifest and verifies its Sigstore signature;
4. pulls the container images for the architecture, pinned by digest;
5. detects the Zigbee adapter if it is plugged in;
6. starts Élise and waits for the services to be healthy.

Then open http://<machine-name>.local:8080 to create the administrator account.

If Tailscale is not paired yet, a local service resumes the TV screen setup every minute and finishes it as soon as private access is ready.

Running it again

Running the command again keeps an existing installation: its secrets, volumes, backups and Tailscale identity.

Installed files

Path	Contents
/opt/elise/releases/<version>	Files for each installed release
/opt/elise/current	Link to the active release
/etc/elise/elise.env	The installation’s configuration
/var/lib/elise	Local state, backups and Zigbee status

From a copy of the repository

To install from source, at the root of the repository:

bash scripts/install-complete.sh

Next

The elise command manages the installation: status, logs, updates, backups.