Install the hivepod CLI

hivepod is DockHive’s command-line tool. It deploys folders as apps, manages HivePods and their backups, and runs the DockHive MCP server for AI coding tools. It needs Python 3.9 or later.

Install

macOS and Linux

curl -fsSL https://dockhive.io/install.sh | sh

The script installs hivepod in ~/.hivepods and adds ~/.hivepods/bin to your PATH. Open a new terminal afterwards.

Windows (PowerShell)

irm https://dockhive.io/install.ps1 | iex

The script installs hivepod in %USERPROFILE%\.hivepods and adds it to your user PATH.

pipx / pip

pipx install hivepods-cli

pip install hivepods-cli also works, but may put hivepod in a folder that isn’t on your PATH; python3 -m hivepods_cli always works.

Check it:

hivepod --version

To upgrade, run the install command again.

Installer options

Variable	Meaning
HIVEPODS_VERSION	Install a specific version, for example 0.2.1.
HIVEPODS_HOME	Install somewhere other than ~/.hivepods.
HIVEPODS_NO_MODIFY_PATH=1	Don’t edit your shell profile (macOS and Linux).
PYTHON	The Python 3.9+ interpreter to use.

No Python? On macOS run xcode-select --install (or brew install python); on Debian or Ubuntu, sudo apt install python3 python3-venv; on Windows, winget install Python.Python.3.12.

Sign in

hivepod login

Your browser opens the DockHive console. Approve the request and return to the terminal. Your email address must be verified.

• No browser on this machine? hivepod login --no-browser signs in with your email and password (and a two-factor code if you use one).

• CI and servers: create an API key and set it in the environment. It’s used instead of a stored sign-in and never written to disk:

  export HIVEPODS_TOKEN=dh_pat_...

Sign out with hivepod logout.

Configuration

Settings live in ~/.hivepods/config.yaml (readable only by you). View and change them with:

hivepod config list
hivepod config set default_size small

Environment variable	Meaning
HIVEPODS_TOKEN	Use an API key instead of the stored sign-in.
HIVEPODS_CONFIG_DIR	Use another config folder (default ~/.hivepods).
HIVEPODS_MCP_LOG	Log level for the MCP server, written to stderr (for example INFO).

Next

• Command reference
• Deploy a folder with hivepod deploy
• Set up the MCP server