Install EarthBuild

Get EarthBuild running on your machine in under a minute.

Prerequisites

EarthBuild requires Docker to be installed and running:

macOS: Docker Desktop for Mac
Linux: Docker Engine
Windows: Docker Desktop for Windows with WSL 2

macOS

Install with Homebrew:

brew tap earthbuild/earthbuild
brew install earth

Or download directly:

curl -fsSL https://www.earthbuild.dev/install.sh | sh

Linux

Install with our script:

curl -fsSL https://www.earthbuild.dev/install.sh | sh

Or install manually:

# Download the latest release
curl -LO https://github.com/EarthBuild/earthbuild/releases/latest/download/earth-linux-amd64

# Make it executable
chmod +x earth-linux-amd64

# Move to your PATH
sudo mv earth-linux-amd64 /usr/local/bin/earth

Windows (WSL 2)

Inside your WSL 2 environment:

curl -fsSL https://www.earthbuild.dev/install.sh | sh

Note: Native Windows support is experimental. We recommend using WSL 2.

Nix / NixOS

EarthBuild is available in nixpkgs:

nix-shell -p earthbuild

Or add to your NixOS configuration:

environment.systemPackages = [ pkgs.earthbuild ];

For nix-darwin:

environment.systemPackages = [ pkgs.earthbuild ];

For home-manager:

home.packages = [ pkgs.earthbuild ];

Verify Installation

earth --version

Bootstrap EarthBuild (first-time setup):

earth bootstrap