Box · Guide
Access, console and monitoring
Recover access, inspect initialization and metrics, and tell guest readiness from VM power state.
SSH and initial credentials
Use an SSH key for routine login. A generated password is available through a one-time reveal action when requested at creation.
- Keep private keys off the Dashboard and never paste one into the public-key field.
- If password reveal is no longer available, use another configured access path or console recovery. The list endpoint does not return stored plaintext passwords.
Browser console
A Box console session is a short-lived, authorized way to view and interact with the guest when SSH or networking is unavailable.
- Open a fresh console session from the Dashboard when needed. Treat its temporary access data as a secret and do not share it.
- The console sees the VM screen, including boot and login errors, but it does not prove that your application is healthy.
Initialization versus power state
A powered-on VM can still be provisioning, waiting for cloud-init, or initialization-failed. Inspect the initialization endpoint to understand guest setup.
- If cloud-init failed, read its output in the guest or console, fix the config, and use the appropriate recovery path. Do not equate running with ready.
- An application listening only on 127.0.0.1 will not be reachable through a published route; check guest bind address and logs.
Metrics and history
Box metrics endpoints expose current and historical host-observed data. Use them with guest logs to diagnose load or capacity pressure.
- Assigned RAM, host RSS, and guest-used memory are different measurements. Guest-used memory is only available when guest memory stats exist.
- The project metrics endpoint provides an aggregate view; per-Box current and history endpoints let you investigate a single VM.
- For disk pressure, compare guest filesystem usage with configured block capacity; host metrics alone cannot tell how much free space a mounted filesystem has.
Automating this workflow
See the matching Box API endpoints for exact request fields and response schemas. Host operations can continue after an API request returns.