## Container Builds

Get faster container image builds by replacing `docker build` with `depot build` using the Depot CLI. If you want to trigger Depot container builds from GitHub Actions, see the [GitHub Actions integration guide](/content/docs/container-builds/integrations/github-actions/index.html).

## Prerequisites

You'll need a [Depot account](/content/sign-up/index.html).

## Install the Depot CLI

Install the [Depot CLI](/content/docs/cli/reference/index.html) on your machine to run local builds.

- **macOS**  
Install the Depot CLI with Homebrew:
    
    ```
    brew install depot/tap/depot
    ```

- **Linux**  
Install the Depot CLI with the installation script:
    
    ```
    curl -L https://depot.dev/install-cli.sh | sh
    ```

- **All platforms**  
Download the binary file for your platform from the [Depot CLI releases page](https://github.com/depot/cli/releases) in GitHub.

## Run a local build

The [`depot build` command](/content/docs/cli/reference/container-builds#depot-build/index.html) 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](/content/docs/container-builds/integrations/aws-codebuild/index.html)
- [Bitbucket Pipelines](/content/docs/container-builds/integrations/bitbucket-pipelines/index.html)
- [Buildkite](/content/docs/container-builds/integrations/buildkite/index.html)
- [CircleCI](/content/docs/container-builds/integrations/circleci/index.html)
- [Depot CI](/content/docs/container-builds/integrations/depot-ci/index.html)
- [GitHub Actions](/content/docs/container-builds/integrations/github-actions/index.html)
- [GitLab CI](/content/docs/container-builds/integrations/gitlab-ci/index.html)
- [Google Cloud Build](/content/docs/container-builds/integrations/google-cloud-build/index.html)
- [Jenkins](/content/docs/container-builds/integrations/jenkins/index.html)
- [Travis CI](/content/docs/container-builds/integrations/travis-ci/index.html)

## 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](/content/orgs/index.html) 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.