We use cookies to understand how people use Depot.
Depot
Sign InGet started
Container Builds

Container build logs

Build logs show the detailed execution output for each container build, including all build steps, cache hits, and any errors encountered during the build process. In the Depot dashboard, you can drill into container build logs down to detailed info about individual steps.

View logs for a build

To view logs for a specific build, open the build details page.

  1. Go to your organization's projects page.
  2. Click a project.
  3. Click the build you want to inspect.

The build page displays the Logs tab by default, showing all build steps.

Project build details page with resource utilization graph, build details, and steps

Understanding the logs view

The logs page displays all build steps in order of execution. For each step, you can see:

  • Platform and stage: The target architecture if building for multiple platforms (linux/amd64, linux/arm64) and the stage name defined in the Dockerfile for multi-stage builds.
  • Step: The Dockerfile instruction (FROM, RUN, COPY, etc.) or build operation.
  • Status: Whether the step was cached, deduplicated, or executed (with duration).

Project build steps

Cached steps show a cached badge instead of execution time. Deduplicated steps show a deduplicated badge indicating the matching step, either from earlier in the build or from other parallel builds.

Filter and search logs

Use the search box at the top of the page to filter steps by name. The search supports fuzzy matching, so you don't need to type the exact step name. Press esc to clear the filter search.

You can also filter steps by status using the filter dropdown:

  • All steps
  • Successful steps
  • Failed steps
  • Canceled steps
  • Cached steps
  • Uncached steps

View detailed step information

To see more details about a specific build step, click on the step name.

Project builds list with duration and cache metrics

The build step panel shows the following:

  • Status, duration (if not cached), target name (if applicable), platform, and step number.
  • Graphs for layer size, step duration, and cache hits for the last 50 builds.
  • Dependency graphic showing which steps feed into this step and what this step outputs.
  • Console output (if any) generated by the step.

Share build logs

To share logs with others, click Share build in the sidebar to generate a public URL. This URL allows anyone with the link to view the build details and logs without requiring authentication.

To stop sharing a build, click Stop sharing in the sidebar.