docs: install instructions

Signed-off-by: Sam Alba <sam.alba@gmail.com>
This commit is contained in:
Sam Alba 2021-05-03 17:21:47 -07:00
parent 43b43f7868
commit 2fdecc045f

View File

@ -1,16 +1,53 @@
# Installing Dagger
1. Build the `dagger` command-line tool. You will need [Go](https://golang.org) version 1.16 or later.
## Option 1 (Mac OS only): install from Homebrew
```
$ make
From your Mac OS terminal, run the following command:
```shell
brew install dagger/tap/dagger
```
2. Copy the `dagger` tool to a location listed in your `$PATH`. For example, to copy it to `/usr/local/bin`:
## Option 2: install from a shell script
```
$ cp ./cmd/dagger/dagger /usr/local/bin
From a terminal, run the following command:
```shell
curl -sfL https://dagger-io.s3.amazonaws.com/dagger/install.sh | sh
```
3. Make sure your machine is running a buildkit daemon. If you have Docker installed, you're already good to go.
Otherwise, install either [Docker](https://www.docker.com/products/docker-desktop) or [buildkit](https://github.com/moby/buildkit#quick-start).
You now have the dagger binary in the local directory under `./bin/dagger`.
You can then install it globally on your system:
```shell
sudo mv ./bin/dagger /usr/local/bin
```
## Option 3: Manually fetch the latest binary release from Github
Open your web browser to [the latest release](https://github.com/dagger/dagger/releases/latest).
From the **assets** section, download the archive corresponding to your OS and Arch.
## Option 4: Compile from source
You will need [Go](https://golang.org) version 1.16 or later.
1. Clone the dagger repository
```shell
git clone https://github.com/dagger/dagger.git
```
2. Build the `dagger` binary.
```shell
cd dagger; make
```
3. Copy the `dagger` tool to a location listed in your `$PATH`. For example, to copy it to `/usr/local/bin`:
```shell
cp ./cmd/dagger/dagger /usr/local/bin
```