Troubleshooting

The app cannot connect

Check that the server is running:

cargo run -p cli -- serve

If the mobile device is on a different network, the detected local address may not be reachable. Set LOKA_CONNECT_HOST to the address clients should use.

The pairing token expired

Normal pairing URLs are valid for 10 minutes. Start the server again or request a fresh pairing URL.

The address is wrong

For custom hostnames or public addresses, run:

LOKA_HOST=0.0.0.0 LOKA_CONNECT_HOST=loka.example.com cargo run -p cli -- serve

Demo setup needs a stable pairing URL

Use demo mode:

LOKA_DEMO=1 cargo run -p cli -- serve

Demo mode pairing URLs are valid for 30 days.