Overview
Last updated
Was this helpful?
Earthly 0.8
Last updated
Was this helpful?
Earthly Cloud is a collection of features that enrich the Earthly experience via cloud-based services. These include:
: Cloud-based BuildKit instances managed by the Earthly team.
: A secret management system that allows you to store secrets in a cloud-based service and use them across builds.
: A feature that allows you to skip large parts of a build in certain situations.
Log sharing: The ability to share build logs with coworkers.
: The ability to authenticate to 3rd-party cloud services without storing long-term credentials.
Get 6,000 build minutes/month on Satellites as part of Earthly Cloud's no time limit free tier. .
To get started with Earthly Cloud, you'll need to register an Earthly account. You can do so by visiting , or by using the CLI as described below.
An email will be sent to you containing a verification token. Next run:
This command will prompt you to set a password, and to optionally register a public-key for password-less authentication.
An Earthly org allows you to share projects, secrets, and satellites with colleagues. To view the orgs you belong to, run:
To create an Earthly org you can run:
To select the org you would like to use, run:
To invite another user to join your org, run:
You can join an Earthly org by following the steps outlined in the invitation email sent to you by an Earthly admin.
To use certain features, Earthly Cloud Secrets, you will additionally need to create an Earthly Project. You can create a project by using the CLI as described below.
To be able to use certain Earthly features, such as Cloud Secrets, or Satellites from your CI, you will need to log into Earthly. The easiest way to do that is to create an Earthly authentication token by running
This token can then be exported as an environment variable in the CI of choice.
Which will then force Earthly to use that token when accessing secrets or satellites.