Valkey

Holden can provision a Valkey container for your app with automatic credential generation. Valkey is a Redis fork with the same protocol and commands—existing Redis clients work without changes.

Enable Valkey

Add valkey to your needs block:

services:
  web:
    image: myapp:latest
    domain: myapp.example.com
    env:
      REDIS_URL: ${needs.valkey.url}

needs:
  valkey:

Available Variables

Variable	Description	Example
${needs.valkey.url}	Full connection URL	redis://:abc123@needs-valkey:6379
${needs.valkey.host}	Container hostname	needs-valkey
${needs.valkey.port}	Port number	6379
${needs.valkey.password}	Generated password	abc123...

Container Details

• Image: valkey/valkey:8-alpine
• Network: Your app’s private network (holden-{app-id})
• Container name: {app-id}-needs-valkey
• Volume: [@base_data_dir]/{app-id}/valkey → /data

Health Checks

Holden waits for Valkey to be ready before starting your app services.

Command: valkey-cli -a <password> PING

• Start period: 5 seconds
• Timeout: 5 seconds per attempt
• Retries: 10 attempts with 3-second intervals