Skip to content

Docker & Docker Compose Quickstart

The official EasyEA container image is freely distributed via GitHub Container Registry (ghcr.io/lhackyup/easy-ea:latest). It bundles both the FastAPI / Python 3.12 backend and the React 18 frontend in a single compact image (< 100 MB idle RAM).

Option 1: Full Stack with PostgreSQL (`docker-compose.yml`)

1. Download the official `docker-compose.yml`

mkdir easyea && cd easyea
curl -O https://easyea.lhackyup.dev/deploy/docker-compose.yml

2. Start the containers

docker compose up -d

On first boot, EasyEA automatically initializes the PostgreSQL schema, registers the 7 Industry Standard Packages (.eap), and seeds the EasyBank demonstration workspace.

3. Open the application

EasyEA Web Application: http://localhost:8000
OpenAPI / Swagger Docs: http://localhost:8000/docs

Option 2: Single-Container Evaluation (`docker run`)

For a quick standalone test using the internal SQLite database:

docker run -d \
  --name easyea-standalone \
  -p 8000:8000 \
  -e EASYEA_ENV=development \
  -e EASYEA_SEED_DEMO_USERS=true \
  ghcr.io/lhackyup/easy-ea:latest