Install the DoltHub CLI#

Download dh from GitHub Releases. Choose the archive for your operating system and processor:

Download checksums.txt from the same release. Compare the archive’s SHA-256 hash with the matching filename in that file before extracting it.

Linux and macOS#

For Linux amd64, run these commands from the download directory:

sha256sum dh-linux-amd64.tar.gz
tar -xzf dh-linux-amd64.tar.gz
mkdir -p "$HOME/.local/bin"
install -m 755 dh "$HOME/.local/bin/dh"

On macOS, substitute your archive name and use shasum -a 256 to calculate the hash. Add the directory containing dh to your shell’s PATH if it is not already there. For example, add this line to your shell configuration and open a new terminal:

export PATH="$HOME/.local/bin:$PATH"

Verify the installation:

dh version

Windows#

From PowerShell in the download directory:

Get-FileHash .\dh-windows-amd64.zip -Algorithm SHA256
Expand-Archive .\dh-windows-amd64.zip -DestinationPath .\dh-cli
.\dh-cli\dh.exe version

Move dh.exe into a directory on your user Path, or add its directory through Environment Variables → User variables → Path. Open a new terminal and run dh version.

Upgrade#

Download and verify the new release, replace the installed executable, and run dh version. If it still reports the previous version, use command -v dh on Linux/macOS or Get-Command dh in PowerShell to find the executable your shell is running.

Shell completion#

The CLI emits completion scripts for Bash, Zsh, Fish, and PowerShell. To enable completion for the current Bash session:

source <(dh completion bash)

For Zsh:

autoload -Uz compinit
compinit
source <(dh completion zsh)

For Fish, save the script in its completion directory:

mkdir -p ~/.config/fish/completions
dh completion fish > ~/.config/fish/completions/dh.fish

For the current PowerShell session:

dh completion powershell | Out-String | Invoke-Expression

For persistent setup, add the appropriate initialization to your shell profile or save the script in your shell’s completion directory. See dh completion.

Build from source#

Source builds require Git, Go 1.26 or newer, and Make for the make build shortcut:

git clone https://github.com/dolthub/cli.git
cd cli
make build
./bin/dh version

Without Make, use go build -o dh ./cmd/dh (or go build -o dh.exe ./cmd/dh on Windows). Move the resulting executable to your PATH as above.

For containers, see Run dh in Docker. Next, create your first database.