LogoLogo
HomeBlogGitHubGet Started FreeLogin
Earthly 0.7
Earthly 0.7
  • 👋Introduction
  • 💻Install Earthly
  • 🎓Learn the basics
    • Part 1: A simple Earthfile
    • Part 2: Outputs
    • Part 3: Adding dependencies With Caching
    • Part 4: Args
    • Part 5: Importing
    • Part 6: Using Docker In Earthly
    • Part 7: Using remote runners
    • Part 8a: Using Earthly in your current CI
    • Final words
  • ⭐Featured guides
    • Rust
  • 📖Docs
    • Guides
      • Importing
      • Build arguments and secrets
      • Functions
      • Using Docker in Earthly
      • Multi-platform builds
      • Authenticating Git and image registries
      • Integration Testing
      • Debugging techniques
      • Podman
      • Configuring registries
        • AWS ECR
        • GCP Artifact Registry
        • Azure ACR
        • Self-signed certificates
      • Using the Earthly Docker Images
        • earthly/earthly
        • earthly/buildkitd
      • ✅Best practices
    • Caching
      • Caching in Earthfiles
      • Managing cache
      • Caching via remote runners
      • Caching via a registry (advanced)
    • Remote runners
    • Earthfile reference
      • Builtin args
      • Excluding patterns
      • Version-specific features
    • The earthly command
    • Earthly lib
    • Configuration reference
    • Examples
    • Misc
      • Alternative installation
      • Data collection
      • Definitions
      • Public key authentication
  • 🔧CI Integration
    • Overview
    • Use the Earthly CI Image
    • Build your own Earthly CI Image
    • Pull-Through Cache
    • Remote BuildKit
    • Vendor-Specific Guides
      • Jenkins
      • Circle CI
      • GitHub Actions
      • AWS CodeBuild
      • Kubernetes
      • Google Cloud Build
      • GitLab CI/CD
      • Woodpecker CI
      • Bitbucket Pipelines
  • ☁️ Earthly Cloud
    • Overview
    • Managing permissions
    • Cloud secrets
    • Earthly Satellites
      • Managing Satellites
      • Using Satellites
Powered by GitBook
On this page
  • Sign up for Earthly Cloud for free!
  • Getting started
  • Creating an account
  • Creating or joining an Earthly org
  • Creating a project
  • Logging in from a CI

Was this helpful?

Edit on GitHub
  1. ☁️ Earthly Cloud

Overview

PreviousBitbucket PipelinesNextManaging permissions

Last updated 1 year ago

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.

Sign up for Earthly Cloud for free!

Get 6,000 build minutes/month on Satellites as part of Earthly Cloud's no time limit free tier. .

Getting started

Creating an account

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.

earthly account register --email <email>

An email will be sent to you containing a verification token. Next run:

earthly account register --email <email> --token <token>

This command will prompt you to set a password, and to optionally register a public-key for password-less authentication.

Creating or joining an Earthly org

An Earthly org allows you to share projects, secrets, satellites and pipelines with colleagues. To view the orgs you belong to, run:

earthly org ls

To create an Earthly org you can run:

earthly org create <org-name>

To select the org you would like to use, run:

earthly org select <org-name>

To invite another user to join your org, run:

earthly org invite <email>

You can join an Earthly org by following the steps outlined in the invitation email sent to you by an Earthly admin.

Creating a project

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.

earthly project create <project-name>

Logging in from a CI

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

earthly account create-token [--write] <token-name>

This token can then be exported as an environment variable in the CI of choice.

EARTHLY_TOKEN=...

Which will then force Earthly to use that token when accessing secrets or satellites.

Earthly Satellites
Earthly Cloud Secrets
Sign up today
Earthly Cloud Sign up page
Auto-skip