Installation

tip

The dagger CLI is available for installation on macOS, Linux, and Windows to run locally or in a CI environment.

Install the dagger CLI following the steps below.

macOS

We assume that you have Homebrew installed. If you do, you can install dagger with a single command:

brew install dagger/tap/dagger

This installs dagger in:

type dagger
# macOS ARM:
dagger is /opt/homebrew/bin/dagger
# macOS Intel:
dagger is /usr/local/bin/dagger

If you do not have Homebrew installed, or you want to install a specific version of dagger, you can run:

cd /usr/local
curl -L https://dl.dagger.io/dagger/install.sh | DAGGER_VERSION=0.9.7 sh

./bin/dagger version
dagger 0.9.7 (GIT_SHA) darwin/arm64

If your user account doesn't have sufficient privileges to install in /usr/local and sudo is available, use the following command instead:

cd /usr/local
curl -L https://dl.dagger.io/dagger/install.sh | DAGGER_VERSION=0.9.7 sudo sh

linux

The quickest way of installing dagger on Linux is to run the following command:

curl -L https://dl.dagger.io/dagger/install.sh | BIN_DIR=$HOME/.local/bin sh

This installs dagger in $HOME/.local/bin:

type dagger
dagger is $HOME/.local/bin/dagger

If you want to install a specific version of dagger, you can run:

curl -L https://dl.dagger.io/dagger/install.sh | DAGGER_VERSION=0.9.7 sh

./bin/dagger version
dagger 0.9.7 (GIT_SHA) linux/amd64

windows

dagger can be installed in Windows via an installation PowerShell script.

If you want to use the installation script, PowerShell 7.0 or newer is required. From PowerShell, run:

Invoke-WebRequest -UseBasicParsing -Uri https://dl.dagger.io/dagger/install.ps1 | Invoke-Expression

If you want to install Dagger to a different location, pass in a location to the script with the -InstallPath parameter.

$script = Invoke-WebRequest -UseBasicParsing -Uri https://dl.dagger.io/dagger/install.ps1
$params = "-InstallPath C:\temp"
"$script $params" | Invoke-Expression

If you want to install a specific version of dagger, pass in a version number with the -DaggerVersion parameter.

$script = Invoke-WebRequest -UseBasicParsing -Uri https://dl.dagger.io/dagger/install.ps1
$params = "-DaggerVersion 0.9.7"
"$script $params" | Invoke-Expression

Without passing in the -InstallPath, We'll save everything under <your home folder>\dagger

Check that dagger is installed correctly by opening a Command Prompt terminal and run:

where dagger
C:\<your home folder>\dagger\dagger.exe