Common problems
Find the message or problem, then the fix. If nothing fits, collect diagnostics and report it.
In short
- Start with
hallvi status. It shows whether the service and the Pi worker are running. - If Hallvi looks stuck, look for Waiting for you. Approvals and cards wait with no time limit.
- If your laptop cannot open Hallvi on another computer, open the SSH connection first.
Installing
| Problem | Fix |
|---|---|
| Supported releases target Apple-silicon macOS and Ubuntu 24.04 x64 | Use one of those two. Other systems have no release yet. |
| Run as your ordinary user, without sudo | Run the command again without sudo. |
| The archive or manifest does not match the signed release | The installer installed nothing. Run the command again. If it repeats, report it. |
| The release list could not be reached | Check that the computer can reach github.com and api.github.com. |
| On Linux, it cannot reach the user service manager | Run it from a normal login of that user, not through sudo or su. |
| Hallvi did not become ready | Read hallvi logs for the reason. |
hallvi: command not found | Use ~/.local/bin/hallvi. |
| On Linux, Hallvi stops at logout | Run the sudo loginctl enable-linger command that hallvi status prints. |
Opening Hallvi
| Problem | Fix |
|---|---|
| The browser cannot open it | Run hallvi status. If it is stopped, run hallvi start. If the interface is down, read hallvi logs. |
| Your laptop cannot open a Hallvi on another computer | Open the SSH connection first. See Use Hallvi from another computer. |
| No worker is running | Run hallvi restart. Hallvi keeps your typed text. |
Accounts and servers
| Problem | Fix |
|---|---|
| ChatGPT authentication is missing or expired | Reconnect on the ChatGPT & model page in Settings. |
| The model reports a usage or rate limit | Your ChatGPT plan's allowance is used up. Wait, then retry. |
| Hallvi could not open your repository | For a private one, press Connect GitHub and install the GitHub App on it. Also check the address. |
| Signed in to GitHub, but the repository is not readable | Press Choose repositories on GitHub, add it, then press Check again. |
| Connect GitHub in Settings → GitHub so Hallvi can watch this branch | Connect GitHub, even for a public repository, then try again. |
| GitHub has no branch that this login can read | Check the branch name and the GitHub App's access. |
| Your GitHub login has expired | Sign in again on the GitHub page in Settings. |
| Hetzner could not be reached from this computer | Check this computer's network, then try again. |
| This token can read, but not make changes | Make a new Hetzner token with Read & Write. |
| Hetzner does not know this token | Paste the whole token, or make a new one. |
| Nothing answered at that address | Check the address, the SSH port and the server's firewall. |
| A different machine answered at that address | Check the address, and run the command on the right server. |
| It refused Hallvi's key | Run the card's command as the user in the pasted line, then check again. |
sudo asks for a password | Use root, or allow sudo without a password. |
| Hallvi cannot run on this system yet | The server needs 64-bit Linux on x86_64 or arm64. |
| Pi can't use its workspace until Docker is running | Start Docker, or choose On this computer on the Workspace page in Settings. |
Work in progress
| Problem | Fix |
|---|---|
| This conversation was interrupted | Press Continue or Stop. See After an interruption. |
| Hallvi seems stuck | Look for Waiting for you. Approvals and cards wait with no time limit. |
| A command did not finish, or SSH failed | Check that the server is running, then press Ask what went wrong. |
| The turn ended before it finished | Press Try again. |
| Hallvi is installing an update | Wait until it restarts, then send again. |
| Pi has not stopped yet | A command may still be finishing. Press Stop again in a moment. |
Your application
| Problem | Fix |
|---|---|
| The private link does not open | Use Reconnect on the Access page after restoring any laptop-to-Hallvi SSH connection. See Reopen a private link. |
| The public address does not answer | See what the Access page last tested, and ask Hallvi to check. New DNS names can take a while. |
| A deployment failed | See When a deployment fails. |
| An update did not go through | See If an update does not go through. |