Earthly

earthly

Super simple build framework with fast, repeatable builds and an instantly familiar syntax – like Dockerfile and Makefile had a baby.

Runs as earthly|macOS, Linux, Windows|earthly.dev

Open form in Otty otty.toml

Command form

ai-draft · 3 tasks · 13 fields

Execute a build target from an Earthfile (target form). The artifact and image forms, account, org, secrets, satellite and other subcommands are not covered.

Opens the form; the finished command lands at your prompt, unrun

Run in Otty

otty gui earthly

Run an Earthly targetExample values, fixed in this page — nothing here reaches a terminal

Basic

Target*

string

Build args

string

TasksEach one presets the form for one job

Build a target

targetbuild_args

Build in CI mode

targetcibuild_args

Build with interactive debugging

targetinteractivebuild_args

ParametersOnly these flags are editable in the form

Target

Target reference such as +build, ./dir+build or github.com/org/repo+build.
string · positional 0

Build args

Passed after the target, for example --VERSION=1.2.3.
string · positional 1 · repeatable

Push images and run RUN --push

boolean

--push

No output

Do not output any images or artifacts.
boolean

--no-output

Ignore cache

boolean

--no-cache

CI mode

Alias for --no-output --strict.
boolean

--ci

Strict

Disallow features that may create unrepeatable builds.
boolean

--strict

Platform

string

--platformlinux/amd64linux/arm64linux/arm/v7

Secret

Form secret-id=value, or just secret-id to read it from the environment.
string · repeatable

--secret-s

Secret from file

Form secret-id=path.
string · repeatable

--secret-file

Allow privileged RUN

boolean

--allow-privileged-P

Interactive debugging

Drop into a shell when a RUN command fails.
boolean

--interactive-i

Verbose logging

boolean

--verbose

SourcesEvery flag above is checked against these

reference

earthly [options...] <target-ref> [build-args...] ##### `--secret|-s <secret-id>[=<value>]` ##### `--secret-file <secret-id>=<path>` ##### `--push` ##### `--no-output` ##### `--no-cache` ##### `--allow-privileged|-P` ##### `--ci` ##### `--platform <platform>` ##### `--interactive|-i` ##### `--strict` ##### `--verbose` ##### `--config <path>`

manual2026-10-27

docs.earthly.dev

Before it fills your prompt, Otty checks the installed earthly against its version. A form that does not match your version is not offered.