Skip to content

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