Configuration

This document provides an overview of the configuration schema for Bakery, a tool for managing container images. The configuration is defined in a YAML file named bakery.yaml. A template for this file can be created using bakery create project.

Fields marked as “Required” must be provided in the configuration file.

Bakery Configuration

The top-level Bakery configuration, bakery.yaml, is represented in the table below.

Field	Description
repository Repository	(Required) The project’s repository metadata.
registries BaseRegistry array	The global-level registries to push all project images to.
images Image array	The list of images managed by the project.

Example Configuration

repository:
  url: https://github.com/posit-dev/images-shared
  vendor: Posit Software, PBC
  maintainer: Posit Docker Team <docker@posit.co>
  authors:
    - name: Ben Schwedler
      email: ben@posit.co
    - name: Ian Pittwood
      email: ian.pittwood@posit.co

registries:
  - host: ghcr.io
    namespace: posit-dev
  - host: docker.io
    namespace: posit

images:
  - name: workbench
    displayName: Posit Workbench
    description: A containerized image of Posit Workbench, a remote development environment for data scientists.
    documentationUrl: https://docs.posit.co/ide/
    dependencyConstraints:
      - dependency: python
        constraint:
          latest: true
      - dependency: R
        constraint:
          max: "4.4"
          count: 1
    variants:
      - name: Standard
        extension: std
        tagDisplayName: std
        primary: true
        options:
          - tool: goss
            wait: 15
            command: "/usr/bin/supervisord -c /etc/supervisor/supervisord.conf"
      - name: Minimal
        extension: min
        tagDisplayName: min
    versions:
      - name: "2025.05.1+513.pro3"
        subpath: "2025.05"
        latest: true
        dependencies:
          - dependency: python
            version: "3.12.11"
          - dependency: R
            version: "4.4.3"
        os:
        - name: Ubuntu 24.04
          primary: true
          extension: ubuntu2404
          tagDisplayName: ubuntu24.04
        - name: Ubuntu 22.04
          extension: ubuntu2204
          tagDisplayName: ubuntu22.04
      - name: "2024.12.1+563.pro2"
        subpath: "2024.12"
        dependencies:
          - dependency: python
            version: "3.12.9"
          - dependency: R
            version: "4.4.2"
        os:
        - name: Ubuntu 22.04
          primary: true
          extension: ubuntu2204
          tagDisplayName: ubuntu22.04
  - name: workbench-session
    subpath: session
    displayName: Posit Workbench Session
    description: A minimal containerized image for running sessions for Posit Workbench in distributed environments.
    documentationUrl: https://docs.posit.co/ide/server-pro/admin/job_launcher/kubernetes_plugin.html
    versions:
      - name: "2025.05.1+513.pro3"
        subpath: "2025.05"
        latest: true
        os:
        - name: Ubuntu 24.04
          primary: true
          extension: ubuntu2404
          tagDisplayName: ubuntu24.04
        - name: Ubuntu 22.04
          extension: ubuntu2204
          tagDisplayName: ubuntu22.04
      - name: "2024.12.1+563.pro2"
        subpath: "2024.12"
        os:
        - name: Ubuntu 22.04
          primary: true
          extension: ubuntu2204
          tagDisplayName: ubuntu22.04

Metadata Types

Repository

A Repository stores the metadata of the parent source code repository of the project. It is primarily used for labeling images.

Field	Description	Default Value	Example
url HttpUrl	(Required) The URL of the image source code repository. If a protocol is not specified, https:// will be prepended.		“https://github.com/posit-dev/images-shared”
vendor string	The vendor or organization name.	Posit Software, PBC	Example Organization, LLC
maintainer NameEmail or string	The maintainer of the repository/project.	Posit Docker Team <docker@posit.co>	Jane Doe <jane.doe@example.com>
authors NameEmail array or string array	The credited authors of the repository/project.	[]

BaseRegistry

A BaseRegistry represents a container image registry. It does not specify the repository (name) for the image.

Field	Description	Example
host string	The host of the registry.	docker.io, ghcr.io
namespace string	(Optional) The namespace or organization within the registry.	posit-dev, my-org

Registry

A Registry represents a container image registry and includes the name or repository of the image. It is a subclass of BaseRegistry.

This type can be specified for an image or version, but cannot be specified at the top level of the bakery configuration.

A common use is pushing images to a repository name that is different from the name of the image.

Field	Description	Example
host string	The host of the registry.	docker.io, ghcr.io
repository string	The repository (name) of the image in the registry	connect, workbench-preview
namespace string	(Optional) The namespace or organization within the registry.	posit-dev, my-org

Image Specification Types

Image

An Image represents a container image managed by the project. Each image has one or more versions and optionally can have one or more variants and operating systems. New images can be created using the bakery create image command.

Field	Description	Default Value	Example
name string	The name of the image. Used as the image name in tags.		my-image, workbench
displayName string	A human-friendly name for the image. Used in labeling.	<name>.replace("-", " ").title()	My Image
description string	A description of the image. Used in labeling.		An example image.
documentationUrl HttpUrl	A URL to additional image or product documentation. Used in labeling.		https://docs.example.com/my-image
subpath string	The subpath relative from the project root directory where the image’s versions and templates are stored.	<name>	my_image, my/image
extraRegistries Registry or BaseRegistry array	Additional registries to push this image to in addition to the global registries in bakery.yaml.	[]
overrideRegistries Registry or BaseRegistry array	If set, overrides the global registries in bakery.yaml for this image with the given list of registries.	[]
tagPatterns TagPattern array	The list of tag patterns to apply to all versions of this image.	Default Tag Patterns
dependencyConstraints DependencyConstraint array	List of dependencies to install in the image. Versions are calculated from a VersionConstraint	[]
variants ImageVariant array	The list of variants for the image. Each variant should have its own Containerfile.	[]	- name: Minimal
versions ImageVersion array	The list of versions for the image. Each version should have its own directory under the image’s subpath. Cannot be used with matrix.	[]	- name: 2025.07.0
matrix ImageMatrix	A matrix configuration for generating multiple image versions from dependency combinations. Cannot be used with versions.		See ImageMatrix
options ToolOptions array	A list of options to pass to a supported tool when performing an action against the image.	[]
devVersions ImageDevelopmentVersion array	Ephemeral versions resolved at build time from a product channel or dependency prerelease. Built when --dev-versions include or --dev-versions only is passed.	[]	See ImageDevelopmentVersion

Example Image

images:
  - name: workbench
    displayName: Posit Workbench
    description: A containerized image of Posit Workbench, a remote development environment for data scientists.
    documentationUrl: https://docs.posit.co/ide/
    dependencyConstraints:
      - dependency: python
        constraint:
          latest: true
      - dependency: R
        constraint:
          max: "4.4"
          count: 2
    variants:
      - name: Standard
        extension: std
        tagDisplayName: std
        primary: true
        options:
          - tool: goss
            wait: 20
            command: rserver start
      - name: Minimal
        extension: min
        tagDisplayName: min
    versions:
      - name: "2025.05.1+513.pro3"
        subpath: "2025.05"
        latest: true
        dependencies:
          - dependency: python
            version: "3.12.11"
          - dependency: R
            version: "4.4.3"
        os:
          - name: Ubuntu 24.04
            primary: true
            extension: ubuntu2404
            tagDisplayName: ubuntu24.04
          - name: Ubuntu 22.04
            extension: ubuntu2204
            tagDisplayName: ubuntu22.04
      - name: "2024.12.1+563.pro2"
        subpath: "2024.12"
        dependencies:
          - dependency: python
            version: "3.12.9"
          - dependency: R
            version: "4.4.2"
        os:
          - name: Ubuntu 22.04
            extension: ubuntu2204
            tagDisplayName: ubuntu22.04

ImageDevelopmentVersion

An ImageDevelopmentVersion defines an ephemeral version resolved at build time. Unlike static versions, it is not stored on disk — Bakery fetches the version string (and optionally download URLs) from an external source each time a dev build runs. Development versions are included when --dev-versions include or --dev-versions only is passed to bakery build or bakery ci matrix.

Each entry carries a sourceType discriminator that selects the resolution strategy.

Common fields (all sourceTypes):

Field	Description	Default	Example
sourceType string	(Required) Resolution strategy. "stream" resolves from a product release channel; "dependency" resolves from a dependency prerelease.		stream, dependency
os ImageVersionOS array	Operating systems to build for.	[]	- name: Ubuntu 24.04
extraRegistries Registry or BaseRegistry array	Additional registries to push this dev version to. Cannot be set alongside overrideRegistries.	[]
overrideRegistries Registry or BaseRegistry array	Replaces all inherited registries for this dev version. Cannot be set alongside extraRegistries.	[]
values map[string, string]	Arbitrary key-value pairs passed to Jinja2 templates when rendering this dev version.	{}	POSITRON_CHANNEL: dailies

sourceType: stream — Product Channel

Resolves the version from a Posit product release channel. The artifact download URL is fetched from the channel’s CDN and injected into the Containerfile template.

Field	Description	Example
product string	(Required) The Posit product ID.	workbench, workbench-session, connect, package-manager
channel string	(Required) The release channel.	daily, preview

Example:

devVersions:
  - sourceType: stream
    product: workbench
    channel: daily
    overrideRegistries:
      - host: ghcr.io
        namespace: posit-dev
        repository: workbench-preview
    os:
      - name: Ubuntu 24.04
        primary: true
        platforms:
          - linux/amd64
          - linux/arm64
      - name: Ubuntu 22.04

sourceType: dependency — Dependency Prerelease

Resolves the version via the dependency constraint system rather than a product channel. The Containerfile template is responsible for constructing the download URL from Image.Version and any values passed.

Field	Description	Default	Example
dependency string	(Required) The dependency to resolve a version for. Must be a supported dependency type.		positron
prerelease bool	When true, includes the dependency’s prerelease channel in version resolution.	false	true
channel string	The release channel for this dev version. Populates the { Channel } tag variable. Omit for stable dependency resolution. "release" is not accepted.	(none)	daily, preview

Example:

devVersions:
  - sourceType: dependency
    dependency: positron
    prerelease: true
    channel: daily
    values:
      POSITRON_CHANNEL: dailies
    overrideRegistries:
      - host: ghcr.io
        namespace: posit-dev
        repository: workbench-positron-init-preview
    os:
      - name: Ubuntu 24.04
        primary: true
        platforms:
          - linux/amd64
          - linux/arm64

ImageVariant

An ImageVariant represents a variant of an image, such as standard or minimal builds. Each variant is expected have its own Containerfile.<os>.<variant>.

Field	Description	Default Value	Example
name string	(Required) The full human-readable name of the image variant. Used in labeling.		Standard, Minimal
primary bool	Indicates if this is the primary variant of the image. Only one variant should be marked as primary.	false	true
extension string	The file extension for the Containerfile for this variant.	name with special characters removed and lower-cased.	min, minimal
tagDisplayName string	The display name of the variant to be used in tags. This value is passed in as the { Variant } variable in Jinja2 when rendering TagPatterns.	name with disallowed tag characters changed to “-” and lower-cased.	min, minimal
tagPatterns TagPattern array	The list of tag patterns to apply to all image targets of this image variant. These patterns are merged with those defined for the variant’s parent Image.	[]
options ToolOptions array	A list of options to pass to a supported tool when performing an action against this image variant.

Common Image Variants

By default, the image variants for an Image will be set to an empty list [] if no variants are otherwise specified for the Image.

A common pattern is to build a minimal image containing fewer dependencies, and a standard image that builds dependencies into the container.

variants:
  - name: Standard
    extension: std
    tagDisplayName: std
    primary: true
  - name: Minimal
    extension: min
    tagDisplayName: min

ImageMatrix

An ImageMatrix generates multiple image versions from combinations of dependency versions and custom values. This is useful when you need to build an image that lacks a singular component to version on or that requires different dependency combinations (e.g., multiple R and Python version combinations).

Note: An image can have either versions or matrix, but not both.

Field	Description	Default Value	Example
namePattern string	A Jinja2 pattern for generating version names. Available variables: Dependencies.<name> for each dependency and Values.<key> for each value.	Auto-generated from dependencies and values	"r{{ Dependencies.R }}-py{{ Dependencies.python }}"
subpath string	The subpath relative from the image’s subpath where matrix files are stored.	matrix	builds, versions
dependencyConstraints DependencyConstraint array	Dependencies to install, with versions calculated from constraints.	[]	See DependencyConstraint
dependencies DependencyVersions array	Dependencies to install, with explicit version lists.	[]	See DependencyVersions
values map[string, string | list]	Custom key-value pairs for template rendering. Lists generate multiple combinations.	{}	edition: ["community", "pro"]
os ImageVersionOS array	The list of operating systems supported by this matrix.	[]	See ImageVersionOS
extraRegistries Registry or BaseRegistry array	Additional registries to push matrix images to.	[]
overrideRegistries Registry or BaseRegistry array	Registries to use instead of global/image registries. Cannot be used with extraRegistries.	[]

At least one of dependencyConstraints, dependencies, or values must be defined.

Example ImageMatrix

images:
  - name: r-session
    displayName: R Session
    matrix:
      namePattern: "r{{ Dependencies.R }}-py{{ Dependencies.python }}"
      subpath: matrix
      dependencies:
        - dependency: R
          versions: ["4.4.3", "4.3.3"]
        - dependency: python
          versions: ["3.12", "3.11"]
      os:
        - name: Ubuntu 24.04
          primary: true
          extension: ubuntu2404
          tagDisplayName: ubuntu24.04

This generates four image versions: - r4.4.3-py3.12 - r4.4.3-py3.11 - r4.3.3-py3.12 - r4.3.3-py3.11

Latest Tag Selection

When every version-bearing axis (each dependency, each dependencyConstraint after resolution, and each list-typed entry in values) contains version-parseable strings, Bakery automatically marks the cartesian-product row at the maximum version of every axis as the “latest” combination. That row inherits the same latest-family tags applied to non-matrix versions — including the bare latest tag when paired with the primary OS and primary variant.

In the example above, the latest combination is r4.4.3-py3.12. Built against the primary OS and primary variant (if any), it would receive latest, <os>, <variant>, and <os>-<variant> tags in addition to its existing matrix tags.

If any axis has a non-version-parseable entry (e.g., a list-typed values axis containing ["alpha", "beta"]), Bakery emits a warning naming the offending axis and value, and the matrix produces no latest-family tags. Scalar (non-list) values are constant across the cartesian product and do not affect the latest selection.

DependencyConstraint

A DependencyConstraint represents a software dependency installed in a specific image.

At the image level, these are specified through a VersionConstraint.

Field	Description	Default Value	Example
dependency string	(Required) The name of the dependency.		R, python, quarto
constraint VersionConstraint	(Required) Constraints to apply to calculate versions.

Note

The quarto and positron dependency types support an additional prerelease field (default: false). When true, prerelease versions are included in the version calculation.

Each Dependency defines the dependency type, as well as the versions of the dependency that will be installed. The versions can be defined explicitly as an array of strings, or in terms of a version constraint.

VersionConstraint

Field	Description	Default Value	Example
latest bool	Include the latest version.		true, false
count int	Number of minor versions to include.		2, 4
max string	Maximum version to include.		3.13.7, 3.11, 3
min string	Minimum version to include.		4.2.1, 4.3, 4

At least one of latest or max must be specified.

If latest is true and no other fields are set, count defaults to 1.

Example Dependency Version Constraint

dependencyConstraints:
  # Install the latest patch of python minor versions from 3.9 to 3.11, inclusive
  - dependency: python
    constraint:
      max: "3.11"
      min: "3.9"
  # Pin the maximum R version to 4.4.2, and install 3 minor versions
  - dependency: R
    constraint:
      max: "4.4.2"
      count: 3
  # Install the 2 most recent minor versions of quarto, including the pre-release version
  - dependency: quarto
    prerelease: true
    constraint:
      latest: true
      count: 2

ImageVersion

An ImageVersion represents a specific version of an image. Each version should be rendered from templates using the bakery create version command.

Field	Description	Default Value	Example
name string	(Required) The full name of the version.		2025.05.1+513.pro3, 2025.04.2-8, 2025.07.0
subpath string	The subpath relative from the image’s subpath where this version’s files are stored.	name with spaces replaced by “-” and lower-cased.	2025.05.1, 2025.04.2, 2025.07.0
dependencies DependencyVersions array	Dependencies to install in this image version. Versions are explicitly defined as strings.	[]
extraRegistries Registry or BaseRegistry array	Additional registries to push this image version to in addition to the global registries in bakery.yaml and extraRegistries or overrideRegistries if set in the parent Image. Cannot be set with overrideRegistries.	[]
overrideRegistries Registry or BaseRegistry array	If set, overrides the global registries in bakery.yaml and extraRegistries or overrideRegistries if set in the parent Image for this image version with the given list of registries. Cannot be set with extraRegistries.	[]
latest bool	Indicates if this is the latest version of the image. Only one version should be marked as latest.	false	true
os ImageVersionOS array	The list of operating systems supported by this image version. Each operating system should have its own Containerfile.<os>. <variant>.	If another image was previously marked as latest, bakery create version will copy its os list by default. Otherwise [].
values map[string, string]	A map of custom values to pass to Jinja2 templates when rendering this image version.	{}

Example Image Version

versions:
  - name: "2025.05.1+513.pro3"
    subpath: "2025.05"
    latest: true
    dependencies:
      - dependency: python
        version: "3.12.11"
      - dependency: R
        version: "4.4.3"
    os:
      - name: Ubuntu 22.04
    values:
      go_version: "1.25.2"

ImageVersionOS

An ImageVersionOS represents an operating system supported by an image version.

Field	Description	Default Value	Example
name string	(Required) The name and version of the image’s base operating system.		Ubuntu 22.04, Debian 11
primary bool	Indicates if this is the primary operating system of the image version.	true if only one OS is defined, otherwise false.	true
extension string	The file extension for the Containerfile.<os>.<variant> for this operating system.	name with special characters removed and lower-cased.	ubuntu2204, debian11
tagDisplayName string	The display name of the operating system to be used in tags. This value is passed in as the { OS } variable in Jinja2 when rendering TagPatterns.	name with disallowed tag characters changed to “-” and lower-cased.	ubuntu-22.04, debian-11

Example Image Version OS

os:
  - name: Ubuntu 22.04
    primary: true
    extension: ubuntu2204
    tagDisplayName: ubuntu22.04

DependencyVersions

At the version level, dependency versions are specified explicitly.

Field	Description	Default Value	Example
dependency string	(Required) The name of the dependency.		R, python, quarto
version string	Single exact version		3.13.7
versions string array	An array of explicit, exact versions

You must specify either version or versions.

Example Dependency Version List

# Install specific versions of Python and R
dependencies:
  - dependency: python
    versions:
      - "3.13.7"
      - "3.12.5"
  - dependency: R
    versions: ["4.5.1", "4.4.2", "3.6.3"]
  - dependency: quarto
    version: "1.7.34"

Other Types

NameEmail

A NameEmail represents a name and email address pair.

Field	Description	Example
name string	The name of the person.	Jane Doe
email string	The email of the person.	jane.doe@example.com

TagPattern

A TagPattern represents a pattern for tagging images. It can include placeholders that are replaced with actual values when generating tags.

Field	Description
patterns string array	(Required) The list of Jinja2 patterns for the tag.
only TagPatternFilter array	(Optional) A list of conditionals to restrict what image targets the tag patterns apply to. By default, patterns will apply to all image targets.

Pattern Templating

All TagPattern patterns should be valid Jinja2 template strings.

The following variables are available for use in patterns: - { Version }: The version of the image. - { OS }: The operating system of the image. - { Variant }: The variant of the image. - { Name }: The name of the image.

In addition to the default Jinja2 filter functions, the following custom filters are also available for use in patterns: - tagSafe: Replaces disallowed characters in a tag with a hyphen (-). Disallowed characters are any characters other than alphanumeric characters, ., _, or -. - stripMetadata: Removes trailing metadata suffixes in a version that start with - or +. For example, 1.2.3-rc1 becomes 1.2.3. - condense: Removes , ., and - characters. - regexReplace <find> <replace>: Uses re.sub to replace occurrences of the find regex pattern with the replace string.

Default Patterns

By default, the following tag patterns will be used for an Image if no tagPatterns are otherwise specified for the Image or ImageVariant. These patterns mirror the behavior noted in the Image Tags section of the README.

- patterns: ["{{ Version }}-{{ OS }}-{{ Variant }}", "{{ Version | stripMetadata }}-{{ OS }}-{{ Variant }}"]
  only:
    - "all"
- patterns: ["{{ Version }}-{{ Variant }}", "{{ Version | stripMetadata }}-{{ Variant }}"]
  only:
    - "primaryOS"
- patterns: ["{{ Version }}-{{ OS }}", "{{ Version | stripMetadata }}-{{ OS }}"]
  only:
    - "primaryVariant"
- patterns: ["{{ Version }}", "{{ Version | stripMetadata }}"]
  only:
    - "primaryOS"
    - "primaryVariant"
- patterns: ["{{ OS }}-{{ Variant }}"]
  only:
    - "latest"
- patterns: ["{{ OS }}"]
  only:
    - "latest"
    - "primaryVariant"
- patterns: ["{{ Variant }}"]
  only:
    - "latest"
    - "primaryOS"
- patterns: ["latest"]
  only:
    - "latest"
    - "primaryOS"
    - "primaryVariant"

TagPatternFilter

The following filters can be used in the only field of a TagPattern to restrict which image targets the tag patterns apply to:

• all: (Default) Applies to all image targets.
• latest: Applies only to the latest version of the image.
• primaryOS: Applies only to the primary operating system of the image.
• primaryVariant: Applies only to the primary variant of the image.

ToolOptions

A ToolOption represents a set of configurable options for a supported tool. Each instance of a ToolOption applies to a specific tool and must specify a valid tool name.

GossOptions

A GossOption represents options for dgoss tests against an image target.

Field	Description	Default Value	Example
tool “goss” literal string	(Required) The name of the tool.		goss
runtimeOptions string	Additional runtime options to pass to the dgoss container instantiation when running tests.		--privileged
command string	The command to run within the dgoss container. This can be used to start a service in the container for testing.	sleep infinity	start-server
wait int	The number of seconds to wait after container startup before running tests. Useful if there is a service that needs to complete its startup prior to testing.	0	30

SociOptions

A SociOption configures SOCI (Seekable OCI) index generation for an image target. SOCI indexes let container runtimes lazily pull image layers, reducing startup latency for large images.

SOCI options can be set in the options array of an Image or an ImageVariant. When both are present, the variant’s options are merged over the image’s options, with any field not explicitly set on the variant inheriting the image-level value. SOCI conversion runs as a post-build step via bakery soci convert (standalone) or as part of bakery ci publish (config-driven), and only acts on targets where enabled is true.

Field	Description	Default Value	Example
tool “soci” literal string	(Required) The name of the tool.		soci
enabled bool	Enable SOCI conversion for this target. Targets without enabled: true are skipped during conversion.	false	true
span_size int	SOCI zTOC span size, in bytes. If unset, the SOCI default is used.	SOCI default	4194304
min_layer_size int	Minimum layer size, in bytes, for a layer to be indexed. Smaller layers are skipped. If unset, the SOCI default is used.	SOCI default	10485760
prefetch_files string array	Files to mark for prefetch in the SOCI index.	[]
optimizations string array	Optional SOCI optimizations to apply (e.g. xattr).	[]
platforms string array	Platforms to convert. If unset, all platforms in the source image are converted (--all-platforms).	All platforms

Example SociOptions

images:
  - name: workbench
    options:
      - tool: soci
        enabled: true
        min_layer_size: 10485760
    variants:
      - name: Standard
        extension: std
        tagDisplayName: std
        primary: true
        options:
          # Override the image-level SOCI settings for this variant only.
          - tool: soci
            enabled: true
            span_size: 4194304
            platforms:
              - linux/amd64
              - linux/arm64

DevBuildSpec

A DevBuildSpec is a typed payload passed to the --dev-spec CLI option to configure development (daily) version builds. It supports either a dispatch-pinned version or a branch-targeted discovery build. At least one of version or release_branch must be set.

Field	Description	Default Value	Example
version string	A specific development version to build (e.g., 2026.07.0-dev+345-gabc1234). When set, release_branch is ignored — the branch is derived from the version’s YYYY.MM segment. Optional if release_branch is set.	—	2026.07.0-dev+345-gabc1234
channel string	The release channel for stream selection and disambiguation (e.g., stable, preview). Used whether or not version is set; must not conflict with --dev-channel if both are provided.	—	preview
release_branch string	The release branch to fetch development artifacts from (e.g., apple-blossom, 2026.07). Ignored when version is set. Required when version is not set.	—	apple-blossom

Example DevBuildSpec Usage

# Build a specific pinned development version
bakery build --dev-spec '{"version": "2026.07.0-dev+345-gabc1234"}'

# Build from the "apple-blossom" release branch
bakery build --dev-spec '{"release_branch": "apple-blossom"}'

See Also

• Templating Documentation — Jinja2 macros and variables available in image templates
• Architecture Diagrams — Detailed tool behavior and flow diagrams
• Bakery Examples — Real-world bakery.yaml files and step-by-step tutorials