Docker

Remem’s Community Edition core is a single Rust service, remem-server (REST API, storage engine, and MCP server at /mcp, port 4545). Docker Compose is the recommended way to run it; this page covers docker run for cases where you need finer control than a Compose file gives you.

Minimal start

docker run -d \
  --name remem-server \
  -p 4545:4545 \
  rememorg/remem-community:server-latest

This runs without persistence. Stop remem-server and all memories are lost.

With persistence

docker run -d \
  --name remem-server \
  --restart unless-stopped \
  -p 4545:4545 \
  -v remem-data:/var/lib/remem \
  rememorg/remem-community:server-latest

-v remem-data:/var/lib/remem mounts a named Docker volume at the path remem-server uses for all storage (the embedded HNSW, CSR graph, BTree, inverted tag index, and LSM-tree indexes). The volume persists across container restarts.

With authentication

docker run -d \
  --name remem-server \
  --restart unless-stopped \
  -p 4545:4545 \
  -v remem-data:/var/lib/remem \
  -e REMEM_API_KEY=your-secret-key \
  rememorg/remem-community:server-latest

Full production config

docker run -d \
  --name remem-server \
  --restart unless-stopped \
  -p 127.0.0.1:4545:4545 \
  -v remem-data:/var/lib/remem \
  -e REMEM_API_KEY=your-secret-key \
  -e REMEM_ENV=production \
  -e RUST_LOG=info \
  -e REMEM_CORS_ORIGINS=https://yourapp.example.com \
  rememorg/remem-community:server-latest

Binding to 127.0.0.1:4545 prevents direct external access — put Nginx or Caddy in front for TLS termination. REMEM_ENV=production makes remem-server refuse to start with an insecure config (auth disabled, a short/placeholder API key, or empty CORS origins) — see Configuration for the full environment variable reference, including REMEM_RATE_LIMIT_RPS/REMEM_RATE_LIMIT_BURST (on by default at 100 rps / burst 50) and REMEM_API_KEY_SECONDARY (key rotation). Everything else — ports, data directory, HNSW parameters, task intervals — is set via config/remem-server.toml, not environment variables.

Checking logs

docker logs remem-server --follow

Tags

Published to a single Docker Hub repository, rememorg/remem-community, under the server-* tag prefix:

Tag	Description
server-latest	Latest stable release
server-0.1.0	Specific version (recommended for production)
server-edge	Latest commit from main (not for production)