Skip to content

Command reference

Run hivepod <command> --help for details on any command. Wherever a command takes a pod, you can use its name or id.

Command What it does
hivepod login [--no-browser] [-e EMAIL] Sign in to your DockHive account.
hivepod logout Sign out on this computer.
hivepod config list Show the current configuration.
hivepod config set KEY VALUE Set a configuration value, such as default_size or region (your default region for new pods and apps).
Command What it does
hivepod deploy [PATH] Deploy a folder as an app with Drone. See hivepod deploy.
Command What it does
hivepod os [--all] [--family linux|windows|bsd] Operating systems you can launch.
hivepod list List your pods.
hivepod create [NAME] Create a pod: an interactive wizard, or pass --os to script it.
hivepod status POD Show a pod’s status, disk used against its size, and live metrics.
hivepod start POD Start a stopped pod.
hivepod stop POD Stop a running pod (your data stays).
hivepod restart POD Restart a pod.
hivepod suspend POD Suspend (pause) a running pod.
hivepod resume POD Resume a suspended pod.
hivepod connect POD Open an interactive terminal in a pod.
hivepod exec POD COMMAND... Run one command in a pod and print the output (up to 20 seconds).
hivepod exec --detach [--timeout S] [--follow] POD COMMAND... Run a command as a background job (up to 6 hours) and print its id.
hivepod jobs POD List a pod’s recent background jobs.
hivepod job status POD ID [--wait] [--follow] A job’s status and output. --wait/--follow wait for it to end and exit with its exit code (124 timed out, 130 cancelled).
hivepod job cancel POD ID Stop a running job and everything it started.
hivepod cp SRC DEST Copy files or folders to or from a pod (POD:PATH on one side). See Copy files.
hivepod logs POD [--tail N] [-f] Show (or follow) a pod’s logs.
hivepod env POD [KEY=VALUE ...] [--unset KEY] [--cmd "..."] [--apply [-y]] Show or change environment variables and the startup command.
hivepod apply POD [-y] Apply pending environment and startup-command changes. This re-creates the pod: only /home/hivepod/data and /home/hivepod/projects are kept.
hivepod rm POD [-y] Delete a pod permanently. Its backups are kept for 7 days so you can restore them into a new pod; the prompt says how many and until when.

create shows the estimated monthly vCPU-hours of the size and what your plan includes versus bills; see What it costs.

create options:

Option Meaning
--os SLUG Operating system, for example ubuntu-24.04.
--size nano|micro|small|medium Preset size (default micro).
--cpu N --ram 8g --disk 80g Custom size (all three needed).
--region R Region, for example eu (default: your region setting, if any).
--subdomain S The pod’s web address subdomain.
--env KEY=VALUE Environment variable (repeatable).
--cmd "..." Startup command.

Lifecycle commands (start, stop, restart, suspend, resume, apply, rm) wait until done; add --no-wait to return immediately, or --timeout SECONDS to change how long they wait.

Command What it does
hivepod backup create POD [--name LABEL] [--description TEXT] Back up a pod’s data and projects folders.
hivepod backup list [POD] List backups.
hivepod backup list --deleted List backups of deleted pods and the date each is kept until (7 days after the delete).
hivepod backup restore BACKUP_ID NAME [--subdomain S] [--size T] Create a new pod from a backup, including a deleted pod’s backup while it is kept.
hivepod backup rm BACKUP_ID [-y] Delete a backup.
Command What it does
hivepod db list List your databases; the firewall column flags any that are open to the internet.
hivepod db info DB A database’s details and firewall state (never the password).
hivepod db firewall DB Its firewall rules, and the addresses app/pod rules use right now.
hivepod db firewall DB allow IP_OR_CIDR Allow an IPv4 address or range.
hivepod db firewall DB allow --app ID / --pod NAME / --all-apps / --all-pods Allow your apps or pods in the database’s region.
hivepod db firewall DB remove RULE_ID Remove a rule.
hivepod db firewall DB deny-all Close it: remove 0.0.0.0/0 rules and set the default to deny.
hivepod db firewall DB open [--yes] Open it to the whole internet (asks first; not recommended).

DB is a database’s name or id. See Firewall and allowlist.

Command What it does
hivepod mcp Run the DockHive MCP server over stdio. See MCP server.
hivepod mcp --print-config Print ready-made config snippets for Claude, Cursor and Windsurf.