earthly --help
Jump to navigation
Jump to search
earthly --help earthly --verbose
earthly account list-tokens
NAME:
earthly - The CI/CD framework that runs anywhere!
USAGE:
earthly [options] <target-ref>
earthly [options] --image <target-ref>
earthly [options] --artifact <target-ref>/<artifact-path> [<dest-path>]
earthly [options] command [command options]
Executes Earthly builds. For more information see https://docs.earthly.dev/docs/earthly-command.
To get started with using Earthly check out the getting started guide at https://docs.earthly.dev/basics.
For help on build-specific flags try
earthly build --help
VERSION:
v0.8.12 7dbb0eab6af95b6f43483ff4065445470252f522 darwin/arm64; macOS 14.5 homebrew
COMMANDS:
bootstrap Bootstraps earthly installation including buildkit image download and optionally shell autocompletion
docker-build *beta* Build a Dockerfile without an Earthfile
account Create or manage an Earthly account
config Edits your Earthly configuration file
doc Document targets from an Earthfile
init *experimental* Initialize an Earthfile for the current project
ls List targets from an Earthfile
org, orgs Create or manage your Earthly orgs
project, projects Manage Earthly projects
prune Prune Earthly build cache
prune-auto-skip Prune Earthly auto-skip data
registry, registries *beta* Manage registry access
satellite, satellites, sat Create and manage Earthly Satellites
cloud, clouds Configure Cloud Installations for BYOC plans
secret, secrets *beta* Manage cloud secrets
web *beta* Access the web UI via your default browser and print the url
billing, bill *experimental* View Earthly billing info
help, h Shows a list of commands or help for one command
GLOBAL OPTIONS:
--config value Path to config file [$EARTHLY_CONFIG]
--ssh-auth-sock value The SSH auth socket to use for ssh-agent forwarding (default: "/private/tmp/com.apple.launchd.hGJKJhxvAe/Listeners") [$EARTHLY_SSH_AUTH_SOCK]
--auth-token value Force Earthly account login to authenticate with supplied token [$EARTHLY_TOKEN]
--git-username value The git username to use for git HTTPS authentication [$GIT_USERNAME]
--git-password value The git password to use for git HTTPS authentication [$GIT_PASSWORD]
--verbose, -V Enable verbose logging (default: false) [$EARTHLY_VERBOSE]
--buildkit-host value The URL to use for connecting to a buildkit host
If empty, earthly will attempt to start a buildkitd instance via docker run [$EARTHLY_BUILDKIT_HOST]
Disable collection of analytics (default: false) [$EARTHLY_DISABLE_ANALYTICS, $DO_NOT_TRACK]
--env-file-path value Use values from this file as earthly environment variables; values are no longer used as --build-arg's or --secret's (default: ".env") [$EARTHLY_ENV_FILE_PATH]
--arg-file-path value Use values from this file as earthly buildargs (default: ".arg") [$EARTHLY_ARG_FILE_PATH]
--secret-file-path value Use values from this file as earthly secrets (default: ".secret") [$EARTHLY_SECRET_FILE_PATH]
--artifact, -a Output specified artifact; a wildcard (*) can be used to output all artifacts (default: false)
--image Output only docker image of the specified target (default: false)
--push Push docker images and execute RUN --push commands (default: false) [$EARTHLY_PUSH]
--ci Execute in CI mode.
Implies --no-output --strict (default: false) [$EARTHLY_CI]
--output Allow artifacts or images to be output, even when running under --ci mode (default: false) [$EARTHLY_OUTPUT]
--no-output Do not output artifacts or images
(using --push is still allowed) (default: false) [$EARTHLY_NO_OUTPUT]
--no-cache Do not use cache while building (default: false) [$EARTHLY_NO_CACHE]
--auto-skip Skip buildkit if target has already been built (default: false) [$EARTHLY_AUTO_SKIP]
--allow-privileged, -P Allow build to use the --privileged flag in RUN commands (default: false) [$EARTHLY_ALLOW_PRIVILEGED]
--max-remote-cache Saves all intermediate images too in the remote cache (default: false) [$EARTHLY_MAX_REMOTE_CACHE]
--save-inline-cache Enable cache inlining when pushing images (default: false) [$EARTHLY_SAVE_INLINE_CACHE]
--use-inline-cache Attempt to use any inline cache that may have been previously pushed
uses image tags referenced by SAVE IMAGE --push or SAVE IMAGE --cache-from (default: false) [$EARTHLY_USE_INLINE_CACHE]
--interactive, -i Enable interactive debugging (default: false) [$EARTHLY_INTERACTIVE]
--strict Disallow usage of features that may create unrepeatable builds (default: false) [$EARTHLY_STRICT]
--satellite value, --sat value The name of satellite to use for this build. [$EARTHLY_SATELLITE]
--no-satellite, --no-sat Disables the use of a selected satellite for this build. (default: false) [$EARTHLY_NO_SATELLITE]
--buildkit-image value The docker image to use for the buildkit daemon (default: "earthly/buildkitd:v0.8.12") [$EARTHLY_BUILDKIT_IMAGE]
--remote-cache value A remote docker image tag use as explicit cache and optionally additional attributes to set in the image (Format: "<image-tag>[,<attr1>=<val1>,<attr2>=<val2>,...]") [$EARTHLY_REMOTE_CACHE]
--disable-remote-registry-proxy Don't use the Docker registry proxy when transferring images (default: false) [$EARTHLY_DISABLE_REMOTE_REGISTRY_PROXY]
--no-auto-skip Disable auto-skip functionality (default: false) [$EARTHLY_NO_AUTO_SKIP]
--github-annotations Enable Git Hub Actions workflow specific output (default: false) [$GITHUB_ACTIONS]
--help, -h show help
--version, -v print the version
Related[edit]
See also[edit]
- Earthly.dev,
earthly [ --push | orgs | docker-build | --version | --help ], Earthfile, Earthly Satellites, Earthly Cloud
Advertising:
