> ## Documentation Index
> Fetch the complete documentation index at: https://grounds-docs-platform-architecture.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Adding a New Container

> Step-by-step guide to add a new container to the repository

<Info>
  **Prerequisites**:

  * Docker available locally
  * Write access to the containers repository
  * Familiarity with the existing image layout and release workflows
</Info>

Use these steps to add a new container to the repository.

<Steps>
  <Step title="Create Container Directory">
    Create a new directory that matches the container name:

    ```bash theme={null}
    mkdir your-container-name
    cd your-container-name
    ```
  </Step>

  <Step title="Create Dockerfile">
    Create a `Dockerfile` with required OCI labels. Use `dev-container-node/Dockerfile` as a reference for the structure and required labels.

    <Check>
      Verify that the image metadata and labels match the existing repository pattern before you continue.
    </Check>
  </Step>

  <Step title="Create Container README">
    Create a `README.md` in your container directory with:

    * Container description
    * Usage instructions
    * Environment variables
    * Examples
  </Step>

  <Step title="Update Release Please Configuration">
    Add your container to `release-please-config.json`:

    ```json theme={null}
    {
      "packages": {
        "dev-container-node": {
          "release-type": "simple",
          "package-name": "dev-container-node"
        },
        "your-container-name": {
          "release-type": "simple",
          "package-name": "your-container-name"
        }
      }
    }
    ```
  </Step>

  <Step title="Update GitHub Workflow">
    Update the container matrix in all workflows so the new container builds:

    ### docker-build-push.yml

    Add your container to `strategy.matrix.container`. This controls build/push and tag matching for `{container}@x.y.z`.

    ### ci.yml

    Add your container to `strategy.matrix.container` for CI build validation.
  </Step>

  <Step title="Update Dependabot (Optional)">
    If your container has dependencies that need monitoring, update `.github/dependabot.yml` to include your container directory.

    <Check>
      Verify that the container is present in the release configuration and CI workflow matrix before you open a pull request.
    </Check>
  </Step>
</Steps>

## Resources

For detailed instructions and examples, see the [containers repository README](https://github.com/groundsgg/containers/).