Skip to content

Install on Linux

Who this is for
Ubuntu 24.04+ or Debian trixie+
You need
A terminal with sudo
Time
5 minutes

The one-line installer supports Ubuntu 24.04 and later and Debian trixie and later, on 64-bit x86 and ARM. It adds Waired’s apt repository, so updates arrive the same way as the rest of your system packages.

  1. Open a terminal and run:

    Terminal window
    curl -fsSL https://github.com/waired-ai/waired-agent/releases/latest/download/install.sh | sh
  2. Read the summary it prints, and press Enter at Proceed? [Y/n].

  3. Enter your password when asked. Nothing appears on screen as you type — that is normal.

Now sign in and set up.

The one-liner only knows how to set up apt repositories, so Fedora, Arch, Alpine and the rest are not covered yet. You can still run Waired by taking the binaries from the latest release and registering the service yourself, but nothing about that path is automated and updates are manual.

GNOME does not show icons next to the clock without an extension, so Waired’s icon needs the AppIndicator extension. Setup installs and enables one automatically when it detects GNOME. If the icon still does not appear, see Troubleshooting. KDE Plasma needs nothing.

Waired installs Ollama — the program that runs models — during setup, and only on computers that will run models. To make sure it is never installed:

Terminal window
curl -fsSL https://github.com/waired-ai/waired-agent/releases/latest/download/install.sh | sh -s -- --skip-ollama
Packages waired, waired-tray (from Waired’s apt repository)
Background service waired-agent.service (systemd), starts at boot
Settings /etc/waired
State /var/lib/waired