Below is a guide to leveraging Depot for up to 40x faster container image builds with a literal drop-in replacement for docker build
.
We also offer managed GitHub Actions Runners with 10x faster caching, you can get started with our runners in our GitHub Actions Overview docs.
For Mac, you can install the CLI with Homebrew:
For Linux, you can install the CLI with our installation script:
For all other platforms, you can download the binary directly from the latest release.
Organizations are the top level entity in Depot. They typically represent a single company or team. Billing details are attached to an organization.
Create Organization
buttonCreate organization
A project is like a cache namespace. Any Dockerfile
or git
repositories you build within a project will share the same cache. When you have a service, Docker image, or repository that should be segregated, you should create a new project.
Create Project
buttonCreate Project
Note: You can always change the region and cache storage policy for a project later.
There are two options for running local builds with Depot. You can use our depot build
command which is a drop-in replacement for your existing docker build
command.
Once you've initialized your project, you can run depot build
to build your Docker image. The build
command takes all of the same parameters as your normal docker build
command.
Your first depot build
locally will ask you to authenticate with Depot and choose the project for your build. The CLI will prompt you to save this project in a depot.json
file in your repository. This file is used to remember your project for future builds.
Note: You can also specify a DEPOT_PROJECT_ID
environment variable instead of saving a depot.json
file.
docker build
There is the option to configure your existing docker build
commmands to leverage Depot behind the scenes for the build. This is done by configuring Depot as a plugin for the Docker CLI. You can see our depot configure-docker
docs for more information.
Integrating Depot into your CI workflow is a very similar process. Depot works with any CI provider, you can find guides for our most popular providers:
By default, an organization is allowed to use unlimited build minutes in a month. However, you can configure a usage cap on your organization to avoid runaway costs.
Settings
buttonUsage caps
section you can choose between two options: