Quick start

Assuming you've already installed both binaries.

1. Start the server (dev/self-signed — see Server reference for production TLS notes):

   potaru-server run --self-signed --state-dir ./state
   

2. Set up the admin account. Visit https://localhost:8443, click through the self-signed cert warning, and fill in the setup form.

3. Create an enrollment token from the dashboard ("Enroll a new agent"), or headlessly:

   potaru-server create-enrollment-token --label "my-laptop" --state-dir ./state
   

4. Enroll the agent on the target machine:

   potaru init --server <server-host>:7000 --token <the-token> --insecure
   potaru run
   

5. Open a shell. Back in the dashboard, the agent shows up online within a few seconds — click it to get a live terminal.

That's it. Every session is logged in the audit log (admin-only, linked from the top nav).