Skip to content
RememRemem Docs

Docker

The Community release is designed to be built with Docker Compose, which includes the Go server, Pebble storage, local embedding runtime, and model. Use Docker Compose for the recommended setup.

Build the image

Section titled “Build the image”

From a Community checkout:

Terminal window
docker build -t remem:0.5.0 -f docker/Dockerfile .

Run with persistence

Section titled “Run with persistence”
Terminal window
mkdir -p ./remem-data
sudo chown 10001:10001 ./remem-data


docker run -d \
  --name remem \
  --restart unless-stopped \
  -p 4545:4545 \
  -v "$PWD/remem-data:/var/lib/remem" \
  -e REMEM_SERVER_API_KEY=your-secret-key \
  -e REMEM_SERVER_ENV=production \
  remem:0.5.0

Pebble keeps the corpus in /var/lib/remem. The bind mount makes it visible to ordinary host backup tools and keeps it across container replacement.

Verify the container

Section titled “Verify the container”
Terminal window
curl http://localhost:4545/api/v1/ready
docker logs remem --follow

The HTTP API and Streamable HTTP MCP endpoint are available on port 4545. For local MCP clients, run the remem-mcp companion binary and point it at http://localhost:4545/mcp.