Skip to main content

Production notes (Docker, ops)

System requirements​

Minimum:

  • Node.js 18+
  • ~512MB RAM
  • SSD recommended

Running in production​

Typical flow:

npm i -g @liorandb/db
NODE_ENV=production PORT=4000 ldb-serve

Use --root to place data on a dedicated volume/disk.

Docker example​

Use the published Docker image (recommended) and mount a local folder for persistence.

Example docker compose (recommended):

Create docker-compose.yml:

services:
  liorandb:
    build:
      context: ..
      dockerfile: docker/Dockerfile
    # image: ldep/liorandb:latest
    container_name: liorandb-test
    ports:
      - "4000:4000"
    environment:
      # Persist data to the mounted volume (recommended for Docker)
      LIORANDB_ROOT_PATH: /data
      # Change this in real deployments
      LIORANDB_RPC_TOKEN: change-me
      # Ensure host port publishing works in single-node mode
      LIORANDB_HTTP_HOST: 0.0.0.0
    volumes:
      - ./lioran-data:/data

Then run:

docker compose up -d

This creates (or reuses) a local folder at ./lioran-data next to where you run docker compose.

Then open Studio:

  • http://localhost:4000

User management (inside container)​

To manage server users with ldb-users, open a shell inside the container:

docker exec -it liorandb sh

If the image has bash, you can use bash instead of sh.

See: User management (ldb-users)

Example:

ldb-users list