Docker Desktop installation

The DataRamen Docker image is distributed via GitHub Container Registry and can be run locally using Docker Desktop.

Note: This guide covers local installation with Docker Desktop. For remote or self-hosted Docker deployments, refer to the Docker installation guide instead.

Prerequisites

• Docker desktop

Installation steps

Start by pulling the DataRamen image from the container registry:

Terminal: pull latest dataramen image

docker pull ghcr.io/oleksandrdemian/dataramen:latest

Create persistent volume

Caution

By default, DataRamen requires a mounted volume to persist data (e.g., the default configuration uses a SQLite database stored on the host).

To retain data across container updates, all DataRamen instances — regardless of image version — should mount the same volume.

Terminal: create persistent volume

docker volume create dataramen-volume

Run the container

Start DataRamen with the persistent volume attached:

Terminal: run dataramen container

docker run -v dataramen-volume:/data -d -p 4466:3000 --name DataRamen ghcr.io/oleksandrdemian/dataramen

This starts a new container named DataRamen on port 4466 in detached mode.