Redis compatibility fixed

Author: DmitryGrigorev

.env.secret.example

@@ -1,12 +1,19 @@
-# .env.secret  —  sensitive values for docker-compose.k8s.yml
+# .env.secret  —  sensitive values for docker-compose
 #
 # !! DO NOT COMMIT THIS FILE TO GIT !!
 # Add to .gitignore:  echo ".env.secret" >> .gitignore
 #
 # Copy this file to .env.secret and fill in real values.
+# Passwords below match the hashes in docker/config/vcache.acl.
 
-# VoidCache password (leave blank to disable auth)
-VC_PASSWORD=
+# VoidCache passwords (must match hashes in vcache.acl)
+VC_PASSWORD_ADMIN=adminpass
+VC_PASSWORD_APP=apppass
+VC_PASSWORD_READER=readonly
+VC_PASSWORD_DEFAULT=secret
+
+# Simple single-password mode (overrides ACL; leave blank to use ACL file)
+# VC_PASSWORD=
 
 # Registry credentials (only needed for private registries)
 # REGISTRY=ghcr.io/yourorg

BUILD.md

@@ -0,0 +1,36 @@
+## 1. Create the secrets file
+
+```bash
+# In PowerShell — run from the project root
+# Leave VC_PASSWORD blank to use the ACL file instead
+Copy-Item docker\.env docker\.env.local
+```
+The ACL file at `docker\config\vcache.acl` 
+already has the correct credentials. 
+You don't need to set VC_PASSWORD unless you want simple password-only mode.
+
+## 2. Build and start
+
+```bash
+# Open PowerShell in the project root folder
+# (right-click the folder → "Open in Terminal")
+
+docker compose -f docker\docker-compose.yml up --build -d
+```
+First build takes 2–3 minutes (downloads Ubuntu base, compiles C source). Subsequent builds are ~20 seconds.
+
+3. Check that all containers are healthy
+```bash
+docker compose -f docker\docker-compose.yml ps
+```
+
+Wait ~30 seconds after start. All four containers (vcache-1, vcache-2, vcache-3, vcache-haproxy) should show healthy or running.
+
+Connect on localhost:6379 (HAProxy) — this is what StackExchange.Redis and RedisInsight should point at.
+```
+Port map
+Port	What	Who connects here
+6379	HAProxy — main entry point	Your app RedisInsight redis-cli
+8404	HAProxy stats UI	Browser → http://localhost:8404/stats (user: admin / pass: admin)
+6381	vcache-0 /
+```

docker/.env

@@ -15,7 +15,8 @@ VC_MAXMEMORY=512m
 VC_THREADS=4
 
 # Simple password — set to enable AUTH on all nodes (leave blank to disable)
-# VC_PASSWORD=changeme_in_production
+# VC_PASSWORD=secret          # matches 'default' user in vcache.acl
+# VC_PASSWORD_ADMIN=adminpass # matches 'admin' user in vcache.acl
 
 # Set to "1" to run nodes without WAL persistence (faster, no durability)
 VC_NO_WAL=0

docker/.env.local

@@ -0,0 +1,22 @@
+# .env  –  VoidCache Docker environment defaults
+#
+# Copy to .env and edit before running docker compose up.
+# All values can also be passed as shell environment variables.
+#
+# ─────────────────────────────────────────────────────────────────────────────
+
+# Port exposed on the host for the HAProxy load balancer
+VC_PORT=6379
+
+# Memory cap per node (supports k, m, g suffixes)
+VC_MAXMEMORY=512m
+
+# Worker threads per node (set to CPU cores for best perf)
+VC_THREADS=4
+
+# Simple password — set to enable AUTH on all nodes (leave blank to disable)
+# VC_PASSWORD=secret          # matches 'default' user in vcache.acl
+# VC_PASSWORD_ADMIN=adminpass # matches 'admin' user in vcache.acl
+
+# Set to "1" to run nodes without WAL persistence (faster, no durability)
+VC_NO_WAL=0

docker/config/vcache.acl

@@ -16,13 +16,13 @@
 # Example users:
 #
 # Full-access admin (password: "adminpass")
-admin  3ba05beee8a9d6c6c5e99bf49e6a17eb6d7f9a5ad5b5bfc14f7c5b0a8d1f2c3  *
+admin  713bfda78870bf9d1b261f565286f85e97ee614efe5f0faf7c34e7ca4f65baca  *
 #
 # Read-only service account (password: "readonly")
-reader e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855  r
+reader 8171bacf32668a8f44b90087ad107ed63170f57154763ba7e44047bf9e5a7be3  r
 #
 # Application account with read+write (password: "apppass")
-app    5e884898da28047151d0e56f8dc6292773603d0d6aabbdd62a11ef721d1542d8  rw
+app    46400f642c99584e51b14031f875ca9b7b33ccf94ff8d7657197a5bac06f4ffb  rw
 #
 # Default user (no-username AUTH <password>)  password: "secret"
 default  2bb80d537b1da3e38bd30361aa855686bde0eacd7162fef6a25fe97bf527a25b  rw