Troubleshooting¶
The demo exits non-zero¶
Cause: an unauthenticated call was accepted, the model name was not
sushi-qwen, or the arithmetic completion did not check out.
Fix: keep the directory under ~/localai-demo/. Read
/opt/sushi/docs/README.md on the instance. Do not delete /etc/localai
to mint a new key.
The client script says the configuration is invalid¶
Cause: client.json is not a single regular file owned by ubuntu,
the mode allows group or other access, the file is larger than 4,096 bytes,
or the endpoint, model, or key shape does not match.
Fix: leave the original file in place. Restore it from the backup you
took with /etc/localai and /var/lib/localai. The script does not rewrite
a file that fails the check.
A call from your laptop is refused¶
Cause: the tunnel is down, or the request has no bearer token. The browser has no chat page on port 8080.
Fix: keep the Session Manager forward running and send the credential from a client that does not put it in the URL. Run the supplied curl block on the instance if you do not yet have a workstation client.
Startup fails after a restore¶
Cause: the state and the credentials are not the pair that first boot created.
Fix: restore /etc/localai, /var/lib/localai, and the ubuntu client
file from the same backup. A partial restore is expected to fail closed.
Last updated November 11, 2026 · Suggest an improvement