Install With Docker

Requirements

Use Docker with Linux containers, Linux 6.1+ and usable io_uring. The image supports linux/amd64 and linux/arm64 and contains the Minimal server build: kernel TCP/io_uring, without SPDK/DPDK or Lavik Admin. The seccomp option allows io_uring in this container; privileged mode is not needed.

1. Start A Standalone Server

docker pull eloqdata/lavik:0.1.0
docker run -d --name lavik   --security-opt seccomp=unconfined   --ulimit memlock=536870912:536870912   -p 127.0.0.1:6379:6379   -v lavik-data:/data   -e LAVIK_DATA_SIZE=1G -e LAVIK_THREADS=2   eloqdata/lavik:0.1.0

The image runs as UID/GID 10001. A named volume avoids host-directory ownership problems. The data file is allocated once; reusing a volume preserves its existing allocation and data. Choose an unused container name and port if another server is running.

2. Connect

docker exec lavik redis-cli PING
docker exec lavik redis-cli SET greeting 'hello from Lavik'
docker exec lavik redis-cli GET greeting
docker logs --tail 50 lavik

3. Preserve Data Across Restarts

docker stop --time 60 lavik
docker start lavik
docker exec lavik redis-cli GET greeting

For container replacement, stop and remove only the container, then run the start command again with the same lavik-data volume. Do not delete that volume unless you intend to erase its data. For replication and failover, use the Compose guide.

Install With Docker Compose →