Docker Deployment¶

Deploys the full VIPR stack: Frontend · API · Celery Worker · Redis.

Quick Start¶

git clone https://codebase.helmholtz.cloud/vipr/vipr-framework.git
cd vipr-framework
cp docker-compose.override.yml.example docker-compose.override.yml
mkdir -p storage/reflectorch/{configs,saved_models}
docker compose up --wait

Frontend: http://localhost:5000
API docs: http://localhost:8000/docs (uncomment ports for vipr-api in docker-compose.override.yml)

Services¶

Service	Purpose	Port
`redis`	Message broker & result backend	6379
`vipr-api`	FastAPI backend	8000
`vipr-worker`	Celery background worker	—
`vipr-frontend`	Nuxt.js web interface	5000

Common Tasks¶

# Logs
docker compose logs -f vipr-api

# Restart a service
docker compose restart vipr-worker

# Pull latest images and restart
docker compose pull && docker compose up -d

# Shell access
docker compose exec vipr-api bash

Troubleshooting¶

Service won’t start

docker compose ps
docker compose logs vipr-api

Permission denied on storage/

sudo chown -R $(id -u):$(id -g) storage/

Storage directory layout (bind-mounted from ./storage/)

storage/
├── reflectorch/    # Reflectorch models and configs
├── huggingface/    # Downloaded HuggingFace models
├── panpe/          # PANPE models
├── results/        # Inference results
└── plugins/        # Runtime plugins

Reset everything

docker compose down --volumes
docker compose up -d

Image Sources¶

Images are pulled from registry.hzdr.de:

registry.hzdr.de/vipr/vipr-api:latest
registry.hzdr.de/vipr/vipr-frontend:latest