Local Development Setup¶

This guide covers building D2S from source with full environment configuration. It is intended for contributors and users who want to customize or extend the platform.

Prerequisites¶

Docker Engine and Docker Compose are required. Verify your setup:

docker --version
docker compose --version

Platform support

D2S containers target the linux/x86_64 architecture. If you are running Docker Desktop on Apple Silicon (ARM), emulation is handled automatically, but you may notice slower build times and startup.

Copy environment files¶

Navigate to the root directory of the repository and copy the example environment files:

cp backend.example.env backend.env
cp db.example.env db.env
cp .env.example .env
cp frontend.example.env frontend.env
cp frontend/.env.example frontend/.env
cp frontend/example.env.development frontend/.env.development

For details on each variable, see the Configuration reference.

Build Docker images¶

Copy the example Docker Compose file and build the images:

cp docker-compose.example.yml docker-compose.yml
docker compose build

Start the containers¶

docker compose up -d

Access the application¶

The D2S web application is available at http://localhost:8000. Replace localhost with the DOMAIN environment variable if you changed it. To use a different port, update the ports setting under the proxy service in docker-compose.yml.

Access the API documentation¶

After starting the containers, interactive API documentation is available at:

Swagger UI: http://localhost:8000/docs
ReDoc: http://localhost:8000/redoc

Stop the containers¶

docker compose stop