Deployment

The Data Harvester stack can be run:

  • via Docker Compose (recommended for local development), or

  • locally (developer-only workflows).

Quickstart with Docker Compose

From the repository root:

docker-compose up -d

This starts:

Service Container Port(s) Notes

Frontend

ai-dapt-frontend

3000

Vue SPA

FastAPI API

dataharvester-app

5002

API endpoints under /data/* and docs under /data/docs

PostgreSQL

postgres-db

5434 (host)

Default user/pass: postgres / postgres

MinIO

minio

9000, 9001

S3 API + console

Redis

redis

6379

Token/public key cache

On first run, PostgreSQL initializes using:

  • postgres/init_testdb.sql

Access points (local)

First-run PostgreSQL timing

On the first docker-compose up, PostgreSQL may still be initializing when the backend starts. A transient failure may occur; Docker typically restarts the backend and it succeeds once PostgreSQL is ready.

If manual intervention is needed:

docker-compose logs postgres-db
docker-compose restart dataharvester-app

See Also