Skip to content
DockHiveDockHiveDockHive Docs

Install DockHive Tunnel

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

Both scripts download the right build for your system (amd64 or arm64) and verify its SHA-256 checksum before installing it. When cosign is installed, the checksum file’s signature is verified too.

  • macOS and Linux install to /usr/local/bin if it’s writable, otherwise to ~/.local/bin.
  • Windows installs to %LOCALAPPDATA%\Programs\dockhive.

Your PATH is set automatically. On macOS and Linux the script adds the install folder to your shell profile (~/.zshrc, ~/.bashrc, fish’s conf.d or ~/.profile) under a # DockHive Tunnel comment; open a new terminal to use dockhive. On Windows it’s added to your user PATH and works in the same window right away.

Install options

Section titled “Install options”
Variable Meaning
DOCKHIVE_INSTALL_DIR Where to put the binary.
DOCKHIVE_VERSION A release tag such as v0.2.1. Default: the latest release.
DOCKHIVE_NO_MODIFY_PATH=1 Don’t edit shell profiles (macOS and Linux).

Set them for the installer’s shell:

Terminal window
curl -fsSL https://dockhive.io/tunnel/install.sh | DOCKHIVE_INSTALL_DIR="$HOME/bin" DOCKHIVE_NO_MODIFY_PATH=1 sh
Terminal window
$env:DOCKHIVE_VERSION = "v0.2.1"; irm https://dockhive.io/tunnel/install.ps1 | iex

Check and update

Section titled “Check and update”
Terminal window
dockhive version

It also tells you (at most once a day) when a newer release exists. Nothing updates automatically: rerun the install line to update. Set DOCKHIVE_NO_UPDATE_CHECK=1 to turn the check off.

Files and settings

Section titled “Files and settings”
OS Config folder
macOS ~/Library/Application Support/dockhive
Linux ~/.config/dockhive (or $XDG_CONFIG_HOME/dockhive)
Windows %AppData%\dockhive

credentials.json in that folder (readable only by you) holds your sign-in. Environment variables:

  • DOCKHIVE_TOKEN: sign in with an API key without storing it.
  • DOCKHIVE_CONFIG_DIR: use another config folder.
  • DOCKHIVE_NO_UPDATE_CHECK=1: don’t check for new releases.

Uninstall

Section titled “Uninstall”
Terminal window
dockhive service uninstall    # if you installed a service
dockhive logout
rm "$(command -v dockhive)"
rm -rf "$HOME/Library/Application Support/dockhive"   # macOS
rm -rf "$HOME/.config/dockhive"                        # Linux

Then delete the # DockHive Tunnel PATH line the installer added to your shell profile.