1.4 Installation guide
Installation Guide
This guide shows you how to install the dagger CLI.
Follow the instructions on the subsequent pages to complete the setup on your operating system of choice.
Note
Find the latest instructions inside the Dagger docs: https://docs.dagger.io/install/Prerequisites
In order to use Dagger you need a few prerequisites. You need a text editor to write and update your Dagger Pipeline. Then you need a container tool such as Docker, which Dagger calls in the background, and then of course the Dagger CLI.
- Editor You need a text editor such as vi, vim, gedit, nano, VSCode, …
- Container Tool The dagger engine is run in a container tool, we highly recommend Docker, as it needs docker compose with root permissions (so it might run buggy with Podman).
- Dagger CLI You have to install the Dagger-CLI on your machine, see below how to achieve this.
In the following you can find installation guides for Linux , MacOS and Windows .
Installation for Linux
Download and install the latest dagger CLI version:
curl -L https://dl.dagger.io/dagger/install.sh | BIN_DIR=$HOME/.local/bin sh
Note
To install a different dagger CLI version, you can specify it using this param, added to the previous command:
DAGGER_VERSION=x.y.z
Check for the newest version here .
Verification
Verify the installation:
which dagger
dagger version
This should output something similar to:
Update
To update your dagger CLI to the latest version, use the same command as for a fresh installation, i.e.:
curl -L https://dl.dagger.io/dagger/install.sh | BIN_DIR=$HOME/.local/bin sh
Check for the newest version and posiible breaking changes in the Change log .
Installation for macOS
Install the latest dagger CLI version using homebrew:
brew install dagger/tap/dagger
Or using sh and curl:
cd /usr/local
curl -L https://dl.dagger.io/dagger/install.sh | sh
Note
To install a different dagger CLI version, you can specify it using this param, added to the previous command:
DAGGER_VERSION=x.y.z
Check for the newest version here .
Verification
Verify the installation:
which dagger
dagger version
This should output something similar to:
Update
To update your dagger CLI to the latest version using homebrew, use this commands:
brew update
brew upgrade dagger
To update using sh and curl instead, use the same commands as for a fresh installation, i.e.:
cd /usr/local
curl -L https://dl.dagger.io/dagger/install.sh | sh
Check for the newest version and posiible breaking changes in the Change log .
Installation for Windows
The dagger CLI can be installed on Windows using a PowerShell 7.0 script:
Invoke-WebRequest -UseBasicParsing -Uri https://dl.dagger.io/dagger/install.ps1 | Invoke-Expression; Install-Dagger
Note
To install a different dagger CLI version, you can specify it using this param, added to the previous command:
-DaggerVersion x.y.z
For further customizations, such as adding Dagger to your system’s PATH or using the interactive installation process, 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
Verification
Verify the installation:
where.exe dagger
This should output something similar to:
Update
To update your dagger CLI to the latest version, use the same command as for a fresh installation, i.e.:
Invoke-WebRequest -UseBasicParsing -Uri https://dl.dagger.io/dagger/install.ps1 | Invoke-Expression; Install-Dagger