Aripa User Docs

Docker

Deploy Aripa with Docker for an easy and reproducible self-hosting setup.

Aripa includes a production Dockerfile that installs only production dependencies, runs as a non-root aripa user, and stores SQLite data in /app/data.

Build the Image

After running the onboarding script:

bun run onboard

Make sure you have:

  • a valid config.json in the project root
  • the required environment variables set in .env

Then build the image:

sudo docker build -t aripa .

Run the Container

Run Aripa with your .env file, bind-mount config.json into the container, and store the SQLite database in a Docker volume:

docker run --rm \
  --env-file .env \
  --mount type=bind,source="$PWD/config.json",target=/app/config.json,readonly \
  --mount type=volume,source=aripa-data,target=/app/data \
  aripa

The aripa-data volume keeps /app/data/aripa.sqlite outside the container, so your database is preserved when the container is removed or recreated.

On this page