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
New project
and specify your preferred region, cache storage policy, and connection.If you're not quite ready to create your own project, every organization comes pre-configured with a default
project that you can use for any container image build. The default project is placed in our US East region with a cache storage policy of 50 GB per image architecture. If you'd like to change those defaults, you can go into the Project > Settings and make any changes.
There are two options for running local builds with Depot.
depot build
commandOur depot build
command is a drop-in replacement for your existing docker build
command.
Once you've created your project in the Depot app, 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
commandThere 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: