Chainguard Container for cockroach

CockroachDB is a cloud-native distributed SQL database designed to build, scale, and manage modern, data-intensive applications.

Chainguard Containers are regularly-updated, secure-by-default container images.

Download this Container Image

For those with access, this container image is available on cgr.dev:

docker pull cgr.dev/ORGANIZATION/cockroach:latest

Be sure to replace the ORGANIZATION placeholder with the name used for your organization's private repository within the Chainguard Registry.

Compatibility Notes

The Chainguard Cockroach Image is comparable to the official Cockroach Image from Docker Hub. However, the Chainguard image does not run as the root user and contains only the minimum set of tools and dependencies needed to function. This means it doesn't include things like a shell or a package manager.

The upstream image explicitly exposes ports 26257 (SQL) and 8080 (HTTP), while the custom image does not. Port mapping needs to be specified during runtime.

Note that Chainguard also offers a cockroach-openssl image which is the upstream equivalent of enabling FIPS. This image is ideal for users prioritizing security, non-root execution, and minimal runtime dependencies.

Getting Started

In this section we will explore how you can use Chainguard's cockroach Image.

Helm Chart

You can use the official helm chart and replace the image in values.yaml with Chainguard image.

You can try running the command below to see an immediate installation of cockroach using Chainguard's image:

helm install cockroach cockroachdb \
  --repo https://charts.cockroachdb.com/ \
  -f values.yaml

With this values.yaml:

tls:
  enabled: false

image:
  repository: cgr.dev/ORGANIZATION/cockroach
  tag: latest

conf:
  single-node: true

Docker

You can run the command below to see an immediate installation of cockroach using Chainguard's image:

docker run -d \
  --name cockroach \
  -p 26257:26257 -p 8080:8080 \
  cgr.dev/ORGANIZATION/cockroach:latest \
  start-single-node --insecure

Documentation and Resources

• Official CockroachDB Documentation

What are Chainguard Containers?

Chainguard Containers are minimal container images that are secure by default.

In many cases, the Chainguard Containers tagged as :latest contain only an open-source application and its runtime dependencies. These minimal container images typically do not contain a shell or package manager. Chainguard Containers are built with Wolfi, our Linux undistro designed to produce container images that meet the requirements of a more secure software supply chain.

The main features of Chainguard Containers include:

• Minimal design, without unnecessary software bloat
• Daily builds to ensure container images are up-to-date with available security patches
• High quality build-time SBOMs attesting to the provenance of all artifacts within the image
• Verifiable signatures provided by Sigstore
• Reproducible builds with Cosign and apko (read more about reproducibility)

For cases where you need container images with shells and package managers to build or debug, most Chainguard Containers come paired with a -dev variant.

Although the -dev container image variants have similar security features as their more minimal versions, they feature additional software that is typically not necessary in production environments. We recommend using multi-stage builds to leverage the -dev variants, copying application artifacts into a final minimal container that offers a reduced attack surface that won’t allow package installations or logins.

Learn More

To better understand how to work with Chainguard Containers, please visit Chainguard Academy and Chainguard Courses.

In addition to Containers, Chainguard offers VMs and Libraries. Contact Chainguard to access additional products.

Trademarks

This software listing is packaged by Chainguard. The trademarks set forth in this offering are owned by their respective companies, and use of them does not imply any affiliation, sponsorship, or endorsement by such companies.