This repository has been archived on 2024-04-08. You can view files and clone it, but cannot push or open issues or pull requests.
Files
dagger/docs/install.md
alefesta 40042204c5 [Installation] - Improve Installation for Windows Users
- **What this feature does**:
Windows user should be able to use the dagger binary getting a similar experience to the one proposed for Linux in the docs.
- **What has been changed**: the feature implement a powershell script similar to `install.sh` logic. More specifically I've updated `install.md` and added `install.ps1`

I'm not sure if the  URL `releases.dagger.io` is currently pointing at the content of GH repo or something else so the documented steps may need a review.

Signed-off-by: alefesta <afesta@alfweb.com>
2021-06-30 16:36:18 +02:00

2.1 KiB

sidebar_position, slug
sidebar_position slug
2 /install

Install Dagger

Option 1: Use Homebrew (Mac OS only)

From your Mac OS terminal, run the following command:

brew install dagger/tap/dagger

If dagger is already installed, you can upgrade it using this command:

brew update; brew upgrade dagger

Option 2: Run a shell script

From a terminal, run the following command:

curl -sfL https://releases.dagger.io/dagger/install.sh | sh

You now have the dagger binary in the local directory under ./bin/dagger.

You can then install it globally on your system:

sudo mv ./bin/dagger /usr/local/bin

Option 2 (Windows): Run a shell script

Since Dagger repository is currently private, we have to use a workaround to be able to run the script and match the latest release. This workaround will be removed once the repo will become public. To generate a personal access token on GitHub follow the guidelines at Create a personal access token

From a terminal, run the following command:

$personalToken= <INSERT YOUR PERSONAL TOKEN>
curl https://releases.dagger.io/dagger/install.ps1 -OutFile install.ps1 ; ./install.ps1 -PersonalToken $personalToken; rm install.ps1

We try to move the dagger binary under C:\Windows\System32 but in case use missing the necessary permission we'll save everything under <your home folder>/dagger

Option 3: Download a binary release

Open your web browser to the latest release.

From the assets section, download the archive corresponding to your OS and Arch.

Option 4: Install from source

You will need Go version 1.16 or later.

1. Clone the dagger repository

git clone https://github.com/dagger/dagger.git

2. Build the dagger binary.

cd dagger; make

3. Copy the dagger tool to a location listed in your $PATH. For example, to copy it to /usr/local/bin:

cp ./cmd/dagger/dagger /usr/local/bin