Installation

info

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 -fsSL https://dl.dagger.io/dagger/install.sh | DAGGER_VERSION=0.13.3 sh

./bin/dagger version
dagger v0.13.3 (registry.dagger.io/engine:v0.13.3) darwin/arm64

View source

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 -fsSL https://dl.dagger.io/dagger/install.sh | DAGGER_VERSION=0.13.3 sudo -E sh

Linux

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

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

View source

note

This installs dagger in $HOME/.local/bin which is not generally in the user's $PATH

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

If you want to set a specific version or install path, you can run:

curl -fsSL https://dl.dagger.io/dagger/install.sh | DAGGER_VERSION=0.13.0 BIN_DIR=/usr/bin sudo -E sh

/usr/bin/dagger version
dagger v0.13.3 (registry.dagger.io/engine:v0.13.3) linux/amd64

Windows

dagger can be installed on Windows via a PowerShell 7.0 script.

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

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

View source

To install Dagger to a custom location, specify the location using the -InstallPath parameter.

Invoke-WebRequest -UseBasicParsing -Uri https://dl.dagger.io/dagger/install.ps1 | Invoke-Expression;
Install-Dagger -InstallPath C:\tools\dagger

To install a specific version of Dagger, specify the version with the -DaggerVersion parameter.

Invoke-WebRequest -UseBasicParsing -Uri https://dl.dagger.io/dagger/install.ps1 | Invoke-Expression;
Install-Dagger -DaggerVersion 0.13.3

For an interactive installation process, include the -Interactive switch.

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

For further customization, such as adding Dagger to your system's PATH, additional parameters are available. To view all available options:

Invoke-WebRequest -UseBasicParsing -Uri https://dl.dagger.io/dagger/install.ps1 | Invoke-Expression;
Get-Command -Name Install-Dagger -Syntax

By default, without specifying the -InstallPath, Dagger will be installed in the <your home folder>\dagger directory.

To verify that Dagger has been installed correctly, use where.exe

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