Install Druk via curl, npm, bun, or Homebrew on Any Platform

Druk ships as a single self-contained executable. There is no runtime to install alongside it — no Node.js, no Bun, no shared libraries to manage. Pick the installation method that suits your workflow and you will have a druk binary ready to run.

Install

curl (recommended)
npm
bun
Homebrew
Direct download

The fastest way to get Druk on macOS or Linux is the official install script. It detects your platform, downloads the correct binary, places it in ~/.druk/bin, and adds that directory to your PATH.

Run the installer

curl -fsSL https://druk.letstri.dev/install | bash

Restart your shell

Open a new terminal session (or source your shell config) so the updated PATH takes effect:

# bash / zsh
source ~/.bashrc   # or ~/.zshrc

# fish
# No action needed — fish_add_path takes effect in the next session

Verify the installation

druk --version

npm install -g druk

The npm (and bun) package is a lightweight launcher that downloads the platform binary on first install. If GitHub is unreachable on your network, set the DRUK_DOWNLOAD_BASE environment variable to a mirror URL before installing.

bun add -g druk

The bun package, like the npm package, is a launcher that fetches the platform binary at install time. Set DRUK_DOWNLOAD_BASE to a mirror if GitHub releases are not reachable.

brew install letstri/tap/druk

Homebrew installs the native binary directly — no download shim involved.

Pre-built binaries for every supported platform are published on the GitHub Releases page.Download the archive for your platform, extract it, and place the druk (or druk.exe) binary somewhere on your PATH:

Platform	Archive
macOS arm64	`druk-darwin-arm64.zip`
macOS x64	`druk-darwin-x64.zip`
Linux arm64	`druk-linux-arm64.tar.gz`
Linux x64	`druk-linux-x64.tar.gz`
Windows x64	`druk-windows-x64.zip`

Install options

The curl installer accepts several flags when you need more control:

curl -fsSL https://druk.letstri.dev/install | bash -s -- --version 1.0.1

Option	Effect
`--version <version>`	Install a specific release instead of the latest (e.g. `1.0.1`).
`--no-modify-path`	Download and place the binary without touching any shell config files.

Where Druk installs

The curl installer places the binary at:

~/.druk/bin/druk

It then appends an export PATH line (or a fish_add_path call for Fish) to your shell config so the binary is on your PATH automatically in every new session.

Upgrading

Run druk update to upgrade to the latest release, regardless of how Druk was originally installed:

druk update

Druk detects which installation method was used by inspecting the path of the running executable, then runs the appropriate upgrade command and prints it before executing:

Install method	Upgrade command run
Homebrew	`brew upgrade letstri/tap/druk`
curl installer	`curl -fsSL https://druk.letstri.dev/install \| bash`
npm	`npm install -g druk@latest`
pnpm	`pnpm add -g druk@latest`
yarn	`yarn global add druk@latest`
bun	`bun add -g druk@latest`
deno	`deno add -g npm:druk@latest`

Running the wrong upgrade command for your install method — for example, npm install -g druk on a Homebrew install — can place a second copy of Druk in a different directory. druk update avoids this by always running the correct command for the detected install.

Verification

Confirm everything is working:

druk --version

You should see the installed version number printed to stdout.

Get Started

Core Features

Configuration

Extending Druk

Install Druk via curl, npm, bun, or Homebrew on Any Platform

Install

Install options

Where Druk installs

Upgrading

Verification

Build docs developers (and LLMs) love

Get Started

Core Features

Configuration

Extending Druk

Documentation Index

​Install

​Install options

​Where Druk installs

​Upgrading

​Verification

Build docs developers (and LLMs) love

Install

Install options

Where Druk installs

Upgrading

Verification