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