ubuntu/valkey Docker Image

ubuntu/valkey is a rock for valkey maintained by https://canonical.com/.

This is an OCI image that bundles Valkey together with the metrics exporter. Valkey is an open source, flexible distributed key-value datastore that is optimized for caching and other realtime workloads.

\https://valkey.io/\]

Tags and Architectures

NOTE: These tags follow a specific naming convention that respects the concept of channels.

Get started

This rock's entrypoint is Pebble, a container-optimized init process that enables the orchestration of a collection of local service processes as an organized set.

\https://documentation.ubuntu.com/pebble/\]

Inspect

To view the https://documentation.ubuntu.com/rockcraft/en/latest/reference/rockcraft-yaml/#services and https://documentation.ubuntu.com/rockcraft/latest/reference/rockcraft-yaml/#checks defined in this rock:

sh
docker run --rm ubuntu/valkey:7.2.7-24.04_stable plan

Run

To run this rock, use any of the usual container runtimes, for example, docker:

sh
docker run --name valkey-container \
    -p 6379:6379 \
    ubuntu/valkey:7.2.7-24.04_stable

Access the Valkey server at http://localhost:6379.

Commands can be run using valkey-cli inside the container, e.g., to check Valkey's status:

shell
$ docker exec valkey-container valkey-cli ping

Get logs

To view the logs of the running container, run:

sh
docker exec valkey-container pebble logs

Or, for a specific service:

sh
docker exec valkey-container pebble logs <service>

Monitor health checks

Rocks may have predefined health checks that you can list by running:

sh
docker exec valkey-container pebble checks

The overall health of your container can be inspected via:

sh
docker exec valkey-container pebble health

Configuration

Environment variables

Volumes

Ports

---

\https://github.com/canonical/charmed-valkey-rock/issues\] \https://github.com/canonical/charmed-valkey-rock\]

Canonical is the provider of this container image. It is the user's responsibility to ensure that any use of this image complies with any relevant licenses for all software contained within, as well as with https://canonical.com/legal/intellectual-property-policy.