Installation
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
- Linux
- Windows
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
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
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
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
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
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