Docker Setup

This guide will help you get Arcadia running quickly using Docker Compose.

Prerequisites

If running docker compose doesn't work, you may have an older version of the docker cli installed and may need to use docker-compose instead.

Also don't forget to use sudo if you aren't in the docker group!

Set up environment files:

# Copy backend environment file
cp backend/.env.docker backend/.env

# Copy frontend environment file
cp frontend/.env.docker frontend/.env

Start all services:
```
docker compose up -d
```
This command will:
- Build the backend and frontend images
- Start PostgreSQL database
- Run database migrations automatically
- Start the backend API server
- Start the frontend development server
Access the application:
- Frontend: http://localhost:5137
- Backend API: http://localhost:8080

If you prefer to start services individually:

docker compose up db -d

docker compose up backend -d

docker compose up frontend -d

For development, you can use Compose Watch to automatically rebuild when source code changes:

docker compose up --watch

Or when running attached (without -d), press W to enable watch mode.

You can optionally add "fake" data (fixtures) to the database for development:

docker exec -i arcadia_db psql -U arcadia -d arcadia < backend/migrations/fixtures/fixtures.sql

The default test user is picolo with password test.

If you added some new test data and wish to include it in your commit, you can export it like so:

docker exec -i arcadia_db pg_dump -U arcadia -d arcadia --data-only --inserts > backend/migrations/fixtures/fixtures.sql

Arcadia automatically runs migrations on launch, but if you need to manually set up the database:

cargo install sqlx-cli
cargo sqlx database setup

If services fail to start, check logs with: docker compose logs [service-name]
To rebuild images: docker compose build
To reset everything: docker compose down -v && docker compose up -d