First steps

Sign in with the account you created in the installer. Then:

1. Update the system

The ISO may be older than the latest image:

sudo bootc upgrade
systemctl reboot

See Updates and rollback.

2. Connect a model

Agents need a model to work with. Add a cloud provider or a local model to the unified model gateway once, and every agent on the system can use it.

3. See your agents

Everything running on the system is already an agent:

ls /agent/local     # every agent on this machine
agentctl ps         # agents and their instances
agenttop            # resources and model usage, live

4. Bring your own agents

Start opencode, Claude Code or any other agent in a terminal as usual. Kleinia recognises it, routes its model calls through the gateway and keeps its context across sessions. See Run your agents.

5. Install apps

Desktop apps come from Flathub, through GNOME Software or flatpak install. See Installing applications.

How permissions work by default

Routine actions run on their own, sensitive actions notify you, and deleting, sending data off the device or changing the system waits for your confirmation. See Permissions and audit.