Log in
Tokens
Authenticate a single invocation with a token, overriding stored credentials:API keys
For CI pipelines, scripts, or agent integrations where the browser login flow is not an option, mint long-lived API keys underboxd auth keys. The raw value is shown only once, at creation time.
--org, the key is fenced to your active org context. --kind member (the default) acts as you within that org. --kind org is a userless service credential limited to the org’s shared machines, and creating one requires org admin.
A --kind org key keeps working after the person who made it leaves the org, so CI doesn’t break when someone moves on. That’s why every admin of the org sees the org’s --kind org keys in boxd auth keys list, whoever made them, and can revoke them with boxd auth keys remove. A member key is listed only for the person who made it.
keys create writes the raw bxd_… value to stdout, while the warning, id, and expiry go to stderr. To put it straight into a GitHub secret without copy and paste:
--json mode is also available for scripting:
Org context
Every account works inside an org, and every user has a default org of their own. Your active context decides which org a new machine is billed to and which machineslist and connect see.
boxd auth switch writes it locally, and each surface (this CLI, the console, other devices) keeps its own. Your default org is a normal org in the list, so you switch back to it by name like any other, and an unset context shows as (default). To run one invocation in a specific org without switching, pass --org.
Sharing machines with the org happens on the machine side. See Organizations in the command reference.