Skip to content

Troubleshooting: Console

Console failures are differentiated so the right fix is obvious.

Symptom code Meaning Action
CONSOLE_GATEWAY_DOWN No healthy console gateway. Start/scale the gateway.
CONSOLE_GATEWAY_UNHEALTHY A gateway is degraded or its heartbeat is stale. Check the gateway.
CONSOLE_PROVIDER_SESSION_FAILED The provider rejected or failed the session. Check the provider.
CONSOLE_INSTANCE_OFFLINE The instance is not running. Start the instance.
CONSOLE_ORIGIN_REJECTED The gateway allow-list rejected the origin. Correct the allowed origins.
CONSOLE_TOKEN_EXPIRED The session token TTL elapsed. Re-open the console.
CONSOLE_SESSION_FAILED A generic session failure. Retry, then inspect the session.
CONSOLE_AGENT_MISSING The agent does not advertise console support. Upgrade the agent or enable console.

Diagnostics never read console content and never terminate an active session.

Check the gateway

php artisan pterocloud:console:gateways
php artisan pterocloud:console:inspect <instance_uuid>
php artisan pterocloud:console:session <session_uuid>

None of these commands print a token.

A black console

A black canvas usually means the session is Disconnected (no gateway or no provider ticket), not a rendering bug. Check the gateway and the provider.