Quickstart for faster Docker image builds

Get faster container image builds by replacing docker build with depot build.

Prerequisites

You'll need a Depot account.

Install the Depot CLI

Install the Depot CLI on your machine to run local builds.

• macOS

  Install the Depot CLI with Homebrew:

  brew install depot/tap/depot

  Copy code

• Linux

  Install the Depot CLI with the installation script:

  curl -L https://depot.dev/install-cli.sh | sh

  Copy code

• All platforms

  Download the binary file for your platform from the Depot CLI releases page in GitHub.

Run a local build

The depot build command accepts the same parameters as the docker build command.

depot build -t repo/image:tag .

When you run depot build locally for the first time, you're prompted to do the following:

• authenticate with Depot
• choose the project for your build
• save the project in a depot.json file in your repository (to remember your project for future builds)

Run a build in CI

Depot integrates with any CI provider. Use the following guides to help you get started:

• AWS CodeBuild
• Bitbucket Pipelines
• Buildkite
• CircleCI
• GitHub Actions
• GitLab CI
• Google Cloud Build
• Jenkins
• Travis CI

Add a build minute usage cap

Organizations have unlimited monthly build minutes by default. To make costs predictable, configure a usage cap for your organization:

1. Log in to your Depot dashboard and select your organization.
2. Click Settings.
3. In the Usage caps section, click Limit build minutes.
4. Enter the number of minutes the organization is allowed to use in a month in the Container Build Minutes field.
5. Click Update limit.

When your organization reaches the build limit, builds won't start until the next billing period or until you raise the limit.