Installation

Pre-requisites (all platforms)

Install earth

Linux

sudo /bin/sh -c 'wget https://github.com/earthly/earthly/releases/latest/download/earth-linux-amd64 -O /usr/local/bin/earth && chmod +x /usr/local/bin/earth'

Alternatively, you may also download the linux binary from the releases page, rename it to earth and place it in your bin.

Mac

Homebrew

brew install earthly

Script

wget https://github.com/earthly/earthly/releases/latest/download/earth-darwin-amd64 -O /usr/local/bin/earth && chmod +x /usr/local/bin/earth

Alternatively, you may also download the darwin binary from the releases page, rename it to earth and place it in your bin.

Windows [experimental]

Windows native version coming soon. The linux version has been reported to just work on WSL.

CI

For instructions on how to install earth for CI use, see the CI integration guide.

Configuration

If you use SSH-based git authentication, then your git credentials will just work with Earthly. Read more about git auth.

For a full list of configuration options, see the Configuration reference

Verify installation

To verify that the installation works correctly, you can issue a simple build of an existing hello-world project

earth github.com/earthly/hello-world+hello

You should see the output

github.com/earthly/hello-world:master+hello | --> RUN [echo 'Hello, world!']
github.com/earthly/hello-world:master+hello | Hello, world!
github.com/earthly/hello-world:master+hello | Target github.com/earthly/hello-world:master+hello built successfully
=========================== SUCCESS ===========================

Syntax highlighting

VS Code extension

Earthfile Syntax Highlighting

Add Earthfile Syntax Highlighting to VS Code.

ext install earthly.earthfile-syntax-highlighting