Nomploy Nomad Packs

← All packs

valkey v0.1.0

Databases

Valkey — an open-source (BSD), high-performance key/value datastore that is a drop-in replacement for Redis (the community fork after Redis's license change). Deployed as a host-networked Nomad service with AOF persistence on a volume.

nomad-pack run valkey --registry nomploy
…or one line (add registry + run)
curl -fsSL https://packs.nomploy.com/install.sh | sh -s -- valkey

Needs nomad-pack on PATH. The script only adds the nomploy registry and runs this pack.

Source ↗ Project ↗ ★ 27.5k ⚑ Report an issue

1 task valkey 6379 1 volume image valkey/valkey:8-alpine pinned :8-alpine image bumped 28 days ago
Pairs with dragonflygarnetredisredis-exporterredisinsight
Alternatives dragonflygarnetmemcachedredis
Variables 9
values.hcl

Save as values.hcl, edit, then run:

nomad-pack run valkey -f values.hcl --registry nomploy
# The name of the Nomad job.
job_name = "valkey"

# The Nomad namespace to deploy into.
namespace = "default"

# The datacenters to deploy to.
datacenters = ["*"]

# The Valkey container image. Pin a tag in production.
image = "valkey/valkey:8-alpine"

# Host port Valkey listens on.
port = 6379

# Optional password (requirepass). Empty = no auth (fine on a trusted network).
password = ""

# Docker named volume for /data (AOF persistence). A fresh volume inherits the image's dir ownership (uid 999), so Valkey can write it.
data_volume = "valkey_data"

# Placement constraints — pin to one node so the local volume stays put. On a nomploy cluster: attribute = "$${meta.nomploy_control_plane}", operator = "=", value = "true".
constraints = []

# The task resources.
resources = {
    cpu    = 300
    memory = 256
  }
NameTypeDefaultDescription
job_name string 
"valkey"
 The name of the Nomad job.
namespace string 
"default"
 The Nomad namespace to deploy into.
datacenters list 
["*"]
 The datacenters to deploy to.
image string 
"valkey/valkey:8-alpine"
 The Valkey container image. Pin a tag in production.
port number 
6379
 Host port Valkey listens on.
password key string 
""
 Optional password (requirepass). Empty = no auth (fine on a trusted network).
data_volume string 
"valkey_data"
 Docker named volume for /data (AOF persistence). A fresh volume inherits the image's dir ownership (uid 999), so Valkey can write it.
constraints list 
[]
 Placement constraints — pin to one node so the local volume stays put. On a nomploy cluster: attribute = "$${meta.nomploy_control_plane}", operator = "=", value = "true".
resources object 
{
    cpu    = 300
    memory = 256
  }
 The task resources.
Back up this pack

This pack stores data in one Docker named volume: valkey_data

⚠ This pack bundles a database. A cold copy of the volume can be inconsistent — for a reliable backup, dump the DB (pg_dump / mysqldump) or stop the job while backing up.

restic

# Run on the node hosting this pack. Point restic at your repo first:
#   export RESTIC_REPOSITORY="s3:https://<account>.r2.cloudflarestorage.com/<bucket>"
#   export RESTIC_PASSWORD="<repo-password>"
#   export AWS_ACCESS_KEY_ID=<key>  AWS_SECRET_ACCESS_KEY=<secret>
restic backup \
  /var/lib/docker/volumes/valkey_data/_data

rclone (sync to S3/R2)

rclone sync /var/lib/docker/volumes/valkey_data/_data backup:<bucket>/valkey_data

Paths assume the default Docker volume location (/var/lib/docker/volumes). Restore by stopping the job, restoring files into the same volume, and re-running the pack.

Readme

valkey

Valkey — an open-source (BSD), high-performance in-memory key/value datastore and a drop-in replacement for Redis. It's the Linux Foundation community fork created after Redis's license change, so it stays fully open. Host-networked Nomad service with AOF persistence on a volume.

Usage

nomad-pack registry add nomploy github.com/Nomploy/nomad-packs
nomad-pack run valkey --registry nomploy

In nomploy: create a Compose service, type Nomad Pack, pack valkey, custom registry github.com/Nomploy/nomad-packs, then Deploy. Point any Redis client at <node-ip>:6379.

Key variables

Variable Default Notes
image valkey/valkey:8-alpine Pin a tag in production.
port 6379 Listen port.
password "" Empty = open; set requirepass.
data_volume valkey_data AOF persistence. Back it up.
constraints [] Pin to a node so the local volume stays put.
resources cpu 300 / mem 256 Raise for larger datasets.

Notes