Back to Setup Guide

Linux Installation

Get Zaluno running on your Linux machine.

Download for Linux

System requirements

  • • Python 3.10 or later
  • • GTK4 and libadwaita
  • • systemd (for background service)
  • • 50 MB free disk space

Supported distributions

Ubuntu 22.04+
Debian 12+
Fedora 38+
Arch Linux

Installation steps

1

Download and extract

Download the latest tarball and extract it:

tar -xzf zaluno-linux-*.tar.gz
cd zaluno-linux
2

Run the setup

The setup command will automatically install our collector and prompt you to login.

zaluno setup
3

Verify it's working

Check the app status. Use any supported AI tool and verify sessions appear in your dashboard.

zaluno status

You're all set!

The installer configures a systemd user service that runs automatically when you log in. Use your AI coding tools as usual — sessions appear in your dashboard within a few minutes.

Troubleshooting

Permission denied running install.sh

run the setup command as sudo.

Browser doesn't open for authentication

Set your default browser or manually open the URL shown in the terminal.

Sessions not syncing

Check if the background service is running: systemctl --user status zaluno-collector

Still having trouble?

Contact support