# Earthly

## Earthly 0.6

- [Introduction](https://docs.earthly.dev/earthly-0.6/readme.md)
- [Learn the basics](https://docs.earthly.dev/earthly-0.6/basics.md)
- [Part 1: A simple Earthfile](https://docs.earthly.dev/earthly-0.6/basics/part-1-a-simple-earthfile.md)
- [Part 2: Outputs](https://docs.earthly.dev/earthly-0.6/basics/part-2-outputs.md)
- [Part 3: Adding dependencies With Caching](https://docs.earthly.dev/earthly-0.6/basics/part-3-adding-dependencies-with-caching.md)
- [Part 4: Args](https://docs.earthly.dev/earthly-0.6/basics/part-4-args.md)
- [Part 5: Importing](https://docs.earthly.dev/earthly-0.6/basics/part-5-importing.md)
- [Part 6: Using Docker In Earthly](https://docs.earthly.dev/earthly-0.6/basics/part-6-using-docker-with-earthly.md)
- [Final words](https://docs.earthly.dev/earthly-0.6/basics/final-words.md)
- [Best practices](https://docs.earthly.dev/earthly-0.6/best-practices.md)
- [Guides](https://docs.earthly.dev/earthly-0.6/docs/guides.md)
- [Authenticating Git and image registries](https://docs.earthly.dev/earthly-0.6/docs/guides/auth.md)
- [Target, artifact and command referencing](https://docs.earthly.dev/earthly-0.6/docs/guides/target-ref.md)
- [Build arguments and secrets](https://docs.earthly.dev/earthly-0.6/docs/guides/build-args.md)
- [User-defined commands (UDCs)](https://docs.earthly.dev/earthly-0.6/docs/guides/udc.md)
- [Managing cache](https://docs.earthly.dev/earthly-0.6/docs/guides/cache.md)
- [Advanced local caching](https://docs.earthly.dev/earthly-0.6/docs/guides/advanced-local-caching.md)
- [Using Docker in Earthly](https://docs.earthly.dev/earthly-0.6/docs/guides/docker-in-earthly.md)
- [Integration Testing](https://docs.earthly.dev/earthly-0.6/docs/guides/integration.md)
- [Debugging techniques](https://docs.earthly.dev/earthly-0.6/docs/guides/debugging.md)
- [Multi-platform builds](https://docs.earthly.dev/earthly-0.6/docs/guides/multi-platform.md)
- [Podman](https://docs.earthly.dev/earthly-0.6/docs/guides/podman.md)
- [Configuring registries](https://docs.earthly.dev/earthly-0.6/docs/guides/configuring-registries.md)
- [AWS ECR](https://docs.earthly.dev/earthly-0.6/docs/guides/configuring-registries/aws-ecr.md)
- [GCP Artifact Registry](https://docs.earthly.dev/earthly-0.6/docs/guides/configuring-registries/gcp-artifact-registry.md)
- [Azure ACR](https://docs.earthly.dev/earthly-0.6/docs/guides/configuring-registries/azure-acr.md)
- [Self-signed certificates](https://docs.earthly.dev/earthly-0.6/docs/guides/configuring-registries/self-signed.md)
- [Using the Earthly Docker Images](https://docs.earthly.dev/earthly-0.6/docs/guides/using-the-earthly-docker-images.md)
- [earthly/earthly](https://docs.earthly.dev/earthly-0.6/docs/guides/using-the-earthly-docker-images/all-in-one.md)
- [earthly/buildkitd](https://docs.earthly.dev/earthly-0.6/docs/guides/using-the-earthly-docker-images/buildkit-standalone.md)
- [Remote runners](https://docs.earthly.dev/earthly-0.6/docs/remote-runners.md)
- [Remote caching](https://docs.earthly.dev/earthly-0.6/docs/remote-caching.md)
- [Earthfile reference](https://docs.earthly.dev/earthly-0.6/docs/earthfile.md)
- [Builtin args](https://docs.earthly.dev/earthly-0.6/docs/earthfile/builtin-args.md)
- [Excluding patterns](https://docs.earthly.dev/earthly-0.6/docs/earthfile/earthlyignore.md)
- [Version-specific features](https://docs.earthly.dev/earthly-0.6/docs/earthfile/features.md)
- [The earthly command](https://docs.earthly.dev/earthly-0.6/docs/earthly-command.md)
- [Configuration reference](https://docs.earthly.dev/earthly-0.6/docs/earthly-config.md)
- [Examples](https://docs.earthly.dev/earthly-0.6/docs/examples.md)
- [Misc](https://docs.earthly.dev/earthly-0.6/docs/misc.md)
- [Alternative installation](https://docs.earthly.dev/earthly-0.6/docs/misc/alt-installation.md)
- [Data collection](https://docs.earthly.dev/earthly-0.6/docs/misc/data-collection.md)
- [Definitions](https://docs.earthly.dev/earthly-0.6/docs/misc/definitions.md)
- [Public key authentication](https://docs.earthly.dev/earthly-0.6/docs/misc/public-key-auth.md)
- [Overview](https://docs.earthly.dev/earthly-0.6/ci-integration/overview.md)
- [Use the Earthly CI Image](https://docs.earthly.dev/earthly-0.6/ci-integration/use-earthly-ci-image.md)
- [Build your own Earthly CI Image](https://docs.earthly.dev/earthly-0.6/ci-integration/build-an-earthly-ci-image.md)
- [Pull-Through Cache](https://docs.earthly.dev/earthly-0.6/ci-integration/pull-through-cache.md)
- [Remote BuildKit](https://docs.earthly.dev/earthly-0.6/ci-integration/remote-buildkit.md)
- [Vendor-Specific Guides](https://docs.earthly.dev/earthly-0.6/ci-integration/vendor-specific-guides.md)
- [Jenkins](https://docs.earthly.dev/earthly-0.6/ci-integration/vendor-specific-guides/jenkins.md)
- [Circle CI](https://docs.earthly.dev/earthly-0.6/ci-integration/vendor-specific-guides/circle-integration.md)
- [GitHub Actions](https://docs.earthly.dev/earthly-0.6/ci-integration/vendor-specific-guides/gh-actions-integration.md)
- [AWS CodeBuild](https://docs.earthly.dev/earthly-0.6/ci-integration/vendor-specific-guides/codebuild-integration.md)
- [Kubernetes](https://docs.earthly.dev/earthly-0.6/ci-integration/vendor-specific-guides/kubernetes.md)
- [Google Cloud Build](https://docs.earthly.dev/earthly-0.6/ci-integration/vendor-specific-guides/google-cloud-build.md)
- [GitLab CI/CD](https://docs.earthly.dev/earthly-0.6/ci-integration/vendor-specific-guides/gitlab-integration.md)
- [Woodpecker CI](https://docs.earthly.dev/earthly-0.6/ci-integration/vendor-specific-guides/woodpecker-integration.md)
- [Overview](https://docs.earthly.dev/earthly-0.6/earthly-cloud/overview.md)
- [Cloud secrets](https://docs.earthly.dev/earthly-0.6/earthly-cloud/cloud-secrets.md)
- [Satellites](https://docs.earthly.dev/earthly-0.6/earthly-cloud/satellites.md)
- [Managing Satellites](https://docs.earthly.dev/earthly-0.6/earthly-cloud/satellites/managing.md)
- [Using Satellites](https://docs.earthly.dev/earthly-0.6/earthly-cloud/satellites/using.md)

## Earthly 0.7

- [Introduction](https://docs.earthly.dev/earthly-0.7/readme.md)
- [Install Earthly](https://docs.earthly.dev/earthly-0.7/install.md)
- [Learn the basics](https://docs.earthly.dev/earthly-0.7/basics.md)
- [Part 1: A simple Earthfile](https://docs.earthly.dev/earthly-0.7/basics/part-1-a-simple-earthfile.md)
- [Part 2: Outputs](https://docs.earthly.dev/earthly-0.7/basics/part-2-outputs.md)
- [Part 3: Adding dependencies With Caching](https://docs.earthly.dev/earthly-0.7/basics/part-3-adding-dependencies-with-caching.md)
- [Part 4: Args](https://docs.earthly.dev/earthly-0.7/basics/part-4-args.md)
- [Part 5: Importing](https://docs.earthly.dev/earthly-0.7/basics/part-5-importing.md)
- [Part 6: Using Docker In Earthly](https://docs.earthly.dev/earthly-0.7/basics/part-6-using-docker-with-earthly.md)
- [Part 7: Using remote runners](https://docs.earthly.dev/earthly-0.7/basics/part-7-using-remote-runners.md)
- [Part 8a: Using Earthly in your current CI](https://docs.earthly.dev/earthly-0.7/basics/part-8a-using-earthly-in-your-current-ci.md)
- [Final words](https://docs.earthly.dev/earthly-0.7/basics/final-words.md)
- [Featured guides](https://docs.earthly.dev/earthly-0.7/featured-guides.md)
- [Rust](https://docs.earthly.dev/earthly-0.7/featured-guides/rust.md)
- [Guides](https://docs.earthly.dev/earthly-0.7/docs/guides.md)
- [Importing](https://docs.earthly.dev/earthly-0.7/docs/guides/importing.md)
- [Build arguments and secrets](https://docs.earthly.dev/earthly-0.7/docs/guides/build-args.md)
- [Functions](https://docs.earthly.dev/earthly-0.7/docs/guides/functions.md)
- [Using Docker in Earthly](https://docs.earthly.dev/earthly-0.7/docs/guides/docker-in-earthly.md)
- [Multi-platform builds](https://docs.earthly.dev/earthly-0.7/docs/guides/multi-platform.md)
- [Authenticating Git and image registries](https://docs.earthly.dev/earthly-0.7/docs/guides/auth.md)
- [Integration Testing](https://docs.earthly.dev/earthly-0.7/docs/guides/integration.md)
- [Debugging techniques](https://docs.earthly.dev/earthly-0.7/docs/guides/debugging.md)
- [Podman](https://docs.earthly.dev/earthly-0.7/docs/guides/podman.md)
- [Configuring registries](https://docs.earthly.dev/earthly-0.7/docs/guides/configuring-registries.md)
- [AWS ECR](https://docs.earthly.dev/earthly-0.7/docs/guides/configuring-registries/aws-ecr.md)
- [GCP Artifact Registry](https://docs.earthly.dev/earthly-0.7/docs/guides/configuring-registries/gcp-artifact-registry.md)
- [Azure ACR](https://docs.earthly.dev/earthly-0.7/docs/guides/configuring-registries/azure-acr.md)
- [Self-signed certificates](https://docs.earthly.dev/earthly-0.7/docs/guides/configuring-registries/self-signed.md)
- [Using the Earthly Docker Images](https://docs.earthly.dev/earthly-0.7/docs/guides/using-the-earthly-docker-images.md)
- [earthly/earthly](https://docs.earthly.dev/earthly-0.7/docs/guides/using-the-earthly-docker-images/all-in-one.md)
- [earthly/buildkitd](https://docs.earthly.dev/earthly-0.7/docs/guides/using-the-earthly-docker-images/buildkit-standalone.md)
- [Best practices](https://docs.earthly.dev/earthly-0.7/docs/guides/best-practices.md)
- [Caching](https://docs.earthly.dev/earthly-0.7/docs/caching.md)
- [Caching in Earthfiles](https://docs.earthly.dev/earthly-0.7/docs/caching/caching-in-earthfiles.md)
- [Managing cache](https://docs.earthly.dev/earthly-0.7/docs/caching/managing-cache.md)
- [Caching via remote runners](https://docs.earthly.dev/earthly-0.7/docs/caching/caching-via-remote-runners.md)
- [Caching via a registry (advanced)](https://docs.earthly.dev/earthly-0.7/docs/caching/caching-via-registry.md)
- [Remote runners](https://docs.earthly.dev/earthly-0.7/docs/remote-runners.md)
- [Earthfile reference](https://docs.earthly.dev/earthly-0.7/docs/earthfile.md)
- [Builtin args](https://docs.earthly.dev/earthly-0.7/docs/earthfile/builtin-args.md)
- [Excluding patterns](https://docs.earthly.dev/earthly-0.7/docs/earthfile/earthlyignore.md)
- [Version-specific features](https://docs.earthly.dev/earthly-0.7/docs/earthfile/features.md)
- [The earthly command](https://docs.earthly.dev/earthly-0.7/docs/earthly-command.md)
- [Earthly lib](https://docs.earthly.dev/earthly-0.7/docs/earthly-lib.md)
- [Configuration reference](https://docs.earthly.dev/earthly-0.7/docs/earthly-config.md)
- [Examples](https://docs.earthly.dev/earthly-0.7/docs/examples.md)
- [Misc](https://docs.earthly.dev/earthly-0.7/docs/misc.md)
- [Alternative installation](https://docs.earthly.dev/earthly-0.7/docs/misc/alt-installation.md)
- [Data collection](https://docs.earthly.dev/earthly-0.7/docs/misc/data-collection.md)
- [Definitions](https://docs.earthly.dev/earthly-0.7/docs/misc/definitions.md)
- [Public key authentication](https://docs.earthly.dev/earthly-0.7/docs/misc/public-key-auth.md)
- [Overview](https://docs.earthly.dev/earthly-0.7/ci-integration/overview.md)
- [Use the Earthly CI Image](https://docs.earthly.dev/earthly-0.7/ci-integration/use-earthly-ci-image.md)
- [Build your own Earthly CI Image](https://docs.earthly.dev/earthly-0.7/ci-integration/build-an-earthly-ci-image.md)
- [Pull-Through Cache](https://docs.earthly.dev/earthly-0.7/ci-integration/pull-through-cache.md)
- [Remote BuildKit](https://docs.earthly.dev/earthly-0.7/ci-integration/remote-buildkit.md)
- [Vendor-Specific Guides](https://docs.earthly.dev/earthly-0.7/ci-integration/vendor-specific-guides.md)
- [Jenkins](https://docs.earthly.dev/earthly-0.7/ci-integration/vendor-specific-guides/jenkins.md)
- [Circle CI](https://docs.earthly.dev/earthly-0.7/ci-integration/vendor-specific-guides/circle-integration.md)
- [GitHub Actions](https://docs.earthly.dev/earthly-0.7/ci-integration/vendor-specific-guides/gh-actions-integration.md)
- [AWS CodeBuild](https://docs.earthly.dev/earthly-0.7/ci-integration/vendor-specific-guides/codebuild-integration.md)
- [Kubernetes](https://docs.earthly.dev/earthly-0.7/ci-integration/vendor-specific-guides/kubernetes.md)
- [Google Cloud Build](https://docs.earthly.dev/earthly-0.7/ci-integration/vendor-specific-guides/google-cloud-build.md)
- [GitLab CI/CD](https://docs.earthly.dev/earthly-0.7/ci-integration/vendor-specific-guides/gitlab-integration.md)
- [Woodpecker CI](https://docs.earthly.dev/earthly-0.7/ci-integration/vendor-specific-guides/woodpecker-integration.md)
- [Bitbucket Pipelines](https://docs.earthly.dev/earthly-0.7/ci-integration/vendor-specific-guides/bitbucket-pipelines-integration.md)
- [Overview](https://docs.earthly.dev/earthly-0.7/earthly-cloud/overview.md)
- [Managing permissions](https://docs.earthly.dev/earthly-0.7/earthly-cloud/managing-permissions.md)
- [Cloud secrets](https://docs.earthly.dev/earthly-0.7/earthly-cloud/cloud-secrets.md)
- [Earthly Satellites](https://docs.earthly.dev/earthly-0.7/earthly-cloud/satellites.md)
- [Managing Satellites](https://docs.earthly.dev/earthly-0.7/earthly-cloud/satellites/managing.md)
- [Using Satellites](https://docs.earthly.dev/earthly-0.7/earthly-cloud/satellites/using.md)

## Earthly 0.8

- [Introduction](https://docs.earthly.dev/readme.md)
- [Install Earthly](https://docs.earthly.dev/install.md)
- [Learn the basics](https://docs.earthly.dev/basics.md)
- [Part 1: A simple Earthfile](https://docs.earthly.dev/basics/part-1-a-simple-earthfile.md)
- [Part 2: Outputs](https://docs.earthly.dev/basics/part-2-outputs.md)
- [Part 3: Adding dependencies With Caching](https://docs.earthly.dev/basics/part-3-adding-dependencies-with-caching.md)
- [Part 4: Args](https://docs.earthly.dev/basics/part-4-args.md)
- [Part 5: Importing](https://docs.earthly.dev/basics/part-5-importing.md)
- [Part 6: Using Docker In Earthly](https://docs.earthly.dev/basics/part-6-using-docker-with-earthly.md)
- [Part 7: Using remote runners](https://docs.earthly.dev/basics/part-7-using-remote-runners.md)
- [Part 8a: Using Earthly in your current CI](https://docs.earthly.dev/basics/part-8a-using-earthly-in-your-current-ci.md)
- [Final words](https://docs.earthly.dev/basics/final-words.md)
- [Featured guides](https://docs.earthly.dev/featured-guides.md)
- [Rust](https://docs.earthly.dev/featured-guides/rust.md)
- [Guides](https://docs.earthly.dev/docs/guides.md)
- [Importing](https://docs.earthly.dev/docs/guides/importing.md)
- [Build arguments and variables](https://docs.earthly.dev/docs/guides/build-args.md)
- [Secrets](https://docs.earthly.dev/docs/guides/secrets.md)
- [Functions](https://docs.earthly.dev/docs/guides/functions.md)
- [Using Docker in Earthly](https://docs.earthly.dev/docs/guides/docker-in-earthly.md)
- [Multi-platform builds](https://docs.earthly.dev/docs/guides/multi-platform.md)
- [Authenticating Git and image registries](https://docs.earthly.dev/docs/guides/auth.md)
- [Integration Testing](https://docs.earthly.dev/docs/guides/integration.md)
- [Debugging techniques](https://docs.earthly.dev/docs/guides/debugging.md)
- [Podman](https://docs.earthly.dev/docs/guides/podman.md)
- [Configuring registries](https://docs.earthly.dev/docs/guides/configuring-registries.md)
- [AWS ECR](https://docs.earthly.dev/docs/guides/configuring-registries/aws-ecr.md)
- [GCP Artifact Registry](https://docs.earthly.dev/docs/guides/configuring-registries/gcp-artifact-registry.md)
- [Azure ACR](https://docs.earthly.dev/docs/guides/configuring-registries/azure-acr.md)
- [Self-signed certificates](https://docs.earthly.dev/docs/guides/configuring-registries/self-signed.md)
- [Using the Earthly Docker Images](https://docs.earthly.dev/docs/guides/using-the-earthly-docker-images.md)
- [earthly/earthly](https://docs.earthly.dev/docs/guides/using-the-earthly-docker-images/all-in-one.md)
- [earthly/buildkitd](https://docs.earthly.dev/docs/guides/using-the-earthly-docker-images/buildkit-standalone.md)
- [Best practices](https://docs.earthly.dev/docs/guides/best-practices.md)
- [Caching](https://docs.earthly.dev/docs/caching.md)
- [Caching in Earthfiles](https://docs.earthly.dev/docs/caching/caching-in-earthfiles.md)
- [Managing cache](https://docs.earthly.dev/docs/caching/managing-cache.md)
- [Caching via remote runners](https://docs.earthly.dev/docs/caching/caching-via-remote-runners.md)
- [Remote runners](https://docs.earthly.dev/docs/remote-runners.md)
- [Earthfile reference](https://docs.earthly.dev/docs/earthfile.md)
- [Builtin args](https://docs.earthly.dev/docs/earthfile/builtin-args.md)
- [Excluding patterns](https://docs.earthly.dev/docs/earthfile/earthlyignore.md)
- [Version-specific features](https://docs.earthly.dev/docs/earthfile/features.md)
- [The earthly command](https://docs.earthly.dev/docs/earthly-command.md)
- [Earthly lib](https://docs.earthly.dev/docs/earthly-lib.md)
- [Configuration reference](https://docs.earthly.dev/docs/earthly-config.md)
- [Examples](https://docs.earthly.dev/docs/examples.md)
- [Misc](https://docs.earthly.dev/docs/misc.md)
- [Alternative installation](https://docs.earthly.dev/docs/misc/alt-installation.md)
- [Data collection](https://docs.earthly.dev/docs/misc/data-collection.md)
- [Definitions](https://docs.earthly.dev/docs/misc/definitions.md)
- [Public key authentication](https://docs.earthly.dev/docs/misc/public-key-auth.md)
- [Overview](https://docs.earthly.dev/ci-integration/overview.md)
- [Use the Earthly CI Image](https://docs.earthly.dev/ci-integration/use-earthly-ci-image.md)
- [Build your own Earthly CI Image](https://docs.earthly.dev/ci-integration/build-an-earthly-ci-image.md)
- [Pull-Through Cache](https://docs.earthly.dev/ci-integration/pull-through-cache.md)
- [Remote BuildKit](https://docs.earthly.dev/ci-integration/remote-buildkit.md)
- [Vendor-Specific Guides](https://docs.earthly.dev/ci-integration/vendor-specific-guides.md)
- [GitHub Actions](https://docs.earthly.dev/ci-integration/vendor-specific-guides/gh-actions-integration.md)
- [Circle CI](https://docs.earthly.dev/ci-integration/vendor-specific-guides/circle-integration.md)
- [GitLab CI/CD](https://docs.earthly.dev/ci-integration/vendor-specific-guides/gitlab-integration.md)
- [Jenkins](https://docs.earthly.dev/ci-integration/vendor-specific-guides/jenkins.md)
- [AWS CodeBuild](https://docs.earthly.dev/ci-integration/vendor-specific-guides/codebuild-integration.md)
- [Google Cloud Build](https://docs.earthly.dev/ci-integration/vendor-specific-guides/google-cloud-build.md)
- [Bitbucket Pipelines](https://docs.earthly.dev/ci-integration/vendor-specific-guides/bitbucket-pipelines-integration.md)
- [Woodpecker CI](https://docs.earthly.dev/ci-integration/vendor-specific-guides/woodpecker-integration.md)
- [Kubernetes](https://docs.earthly.dev/ci-integration/vendor-specific-guides/kubernetes.md)
- [Overview](https://docs.earthly.dev/earthly-cloud/overview.md)
- [Managing permissions](https://docs.earthly.dev/earthly-cloud/managing-permissions.md)
- [Cloud secrets](https://docs.earthly.dev/earthly-cloud/cloud-secrets.md)
- [Earthly Satellites](https://docs.earthly.dev/earthly-cloud/satellites.md)
- [Managing Satellites](https://docs.earthly.dev/earthly-cloud/satellites/managing.md)
- [Using Satellites](https://docs.earthly.dev/earthly-cloud/satellites/using.md)
- [Self-Hosted Satellites](https://docs.earthly.dev/earthly-cloud/satellites/self-hosted.md)
- [GitHub runners](https://docs.earthly.dev/earthly-cloud/satellites/gha-runners.md)
- [Best Practices](https://docs.earthly.dev/earthly-cloud/satellites/best-practices.md)
- [Bring Your Own Cloud (BYOC)](https://docs.earthly.dev/earthly-cloud/satellites/byoc.md)
- [AWS](https://docs.earthly.dev/earthly-cloud/satellites/byoc/aws.md)
- [Requirements](https://docs.earthly.dev/earthly-cloud/satellites/byoc/aws/requirements.md)
- [CloudFormation](https://docs.earthly.dev/earthly-cloud/satellites/byoc/aws/cloudformation.md)
- [Terraform](https://docs.earthly.dev/earthly-cloud/satellites/byoc/aws/terraform.md)
- [Manual](https://docs.earthly.dev/earthly-cloud/satellites/byoc/aws/manual.md)
- [VPN](https://docs.earthly.dev/earthly-cloud/satellites/byoc/vpn.md)
- [Tailscale](https://docs.earthly.dev/earthly-cloud/satellites/byoc/vpn/tailscale.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on a page URL with the `ask` query parameter:
```
GET https://docs.earthly.dev/readme.md?ask=<question>
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.