CLI docs / Troubleshooting
Troubleshooting
Common CLI errors and how to fix them.
Authentication errors
| Error | Fix |
|---|
exit 3: unauthenticated | Run veirox login or set VEIROX_API_KEY. |
token expired | Run veirox login --rotate to mint a fresh key. |
keyring: secret not found | The keyring entry was deleted. Re-run veirox login. |
Project / resource not found
| Error | Fix |
|---|
exit 4: not found | Verify the UUID and that it belongs to the active project. Run veirox project list. |
| Wrong project resources | Set VEIROX_PROJECT_ID or re-run veirox init. |
Permission errors
exit 5: permission denied — your API key lacks the required scope. Create a new key: veirox api-key create --name ci --scope tasks:write.
Network & TLS errors
| Error | Fix |
|---|
dial tcp: connection refused | Check VEIROX_WORKSPACE points to the correct URL. |
| TLS certificate errors | Use https:// not http://. For self-signed certs, install the CA bundle. |
Verbose logging
VEIROX_DEBUG=1 veirox task list 2>&1 | head -50
See also