Avvio Rapido con Docker & Docker Compose

L’immagine container ufficiale di EasyEA è distribuita gratuitamente su GitHub Container Registry (ghcr.io/lhackyup/easy-ea:latest). Include in un unico container compatto (< 100 MB di RAM a riposo) sia il backend FastAPI / Python 3.12 sia il frontend React 18.

---

Prerequisiti

• Docker Engine (v20.10+) e Docker Compose (v2.0+) installati sulla macchina.
• Porta 8000 libera per l’interfaccia web e le API di EasyEA.

---

Opzione 1: Avvio Completo con PostgreSQL (docker-compose.yml)

Questa è la configurazione consigliata per avere persistenza completa su database PostgreSQL 16:

1. Scarica il file docker-compose.yml ufficiale

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

Il contenuto del file docker-compose.yml è il seguente:

services:
  postgres:
    image: postgres:16-alpine
    container_name: easyea-postgres
    restart: unless-stopped
    environment:
      POSTGRES_USER: ${POSTGRES_USER:-easyea}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-easyea_secret}
      POSTGRES_DB: ${POSTGRES_DB:-easyea}
    ports:
      - "${POSTGRES_PORT:-5433}:5432"
    volumes:
      - easyea_pgdata:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-easyea} -d ${POSTGRES_DB:-easyea}"]
      interval: 5s
      timeout: 5s
      retries: 5

  easyea:
    image: ghcr.io/lhackyup/easy-ea:latest
    container_name: easyea-app
    restart: unless-stopped
    depends_on:
      postgres:
        condition: service_healthy
    environment:
      DATABASE_URL: postgresql://${POSTGRES_USER:-easyea}:${POSTGRES_PASSWORD:-easyea_secret}@postgres:5432/${POSTGRES_DB:-easyea}
      EASYEA_ENV: ${EASYEA_ENV:-production}
      EASYEA_SECRET_KEY: ${EASYEA_SECRET_KEY:-change-me-in-production-with-a-strong-random-key}
      EASYEA_RBAC_MODE: ${EASYEA_RBAC_MODE:-hybrid}
      EASYEA_SEED_DEMO_USERS: ${EASYEA_SEED_DEMO_USERS:-true}
    ports:
      - "${EASYEA_PORT:-8000}:8000"

volumes:
  easyea_pgdata:

2. Avvia i container

docker compose up -d

Al primo avvio, EasyEA inizializzerà automaticamente lo schema del database, installerà il catalogo dei 7 Package Standard di Settore (.eap) e popolerà il workspace dimostrativo EasyBank.

3. Accedi all’applicazione

Apri il browser all’indirizzo:

• Applicazione Web EasyEA: http://localhost:8000
• Documentazione OpenAPI / Swagger: http://localhost:8000/docs

(Nota: PostgreSQL è mappato sull’host alla porta 5433 per evitare conflitti con eventuali istanze Postgres già presenti sulla porta standard 5432).

---

Opzione 2: Esecuzione Rapida con Comando Singolo (docker run)

Se vuoi testare rapidamente l’immagine in modalità standalone con database SQLite interno prima di passare a PostgreSQL:

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

---

Aggiornamento all’Ultima Versione

Per aggiornare la tua installazione all’ultima release dell’immagine:

docker compose pull
docker compose up -d