Servono Docker con Compose e Python 3.12 (solo per i test e per generare la chiave). Nessun nodo né dominio: il sito parte su `https://localhost` con la catena **simulata** ([WEB-07](sito-e-app.md)).
```bash
mkdir -p data/db
cp .env.example .env
python3 -c "import secrets; print(secrets.token_urlsafe(64))"# incollare il risultato in DJANGO_SECRET_KEY nel file .env
docker compose up -d --build
```
1. Aprire `https://localhost`: il certificato è autofirmato, l'avviso del browser alla prima visita è atteso.
2. Servizi: `web` (applica le migrazioni), `worker` (apre, chiude ed estrae i round) e `caddy`. Se il worker non gira nessun round si muove: `docker compose logs worker`.
Se `docker compose up` termina con «web is unhealthy» e `docker compose logs web` dice `DJANGO_SECRET_KEY must be at least 50 characters`, la chiave in `.env` è vuota o troppo corta: impostala (comando del passo precedente) e rilancia `docker compose up -d`. Il worker non parte finché `web` non è sano.
3. Registrarsi su `/registrati/`, caricare un deposito di prova in `/app/portafoglio/` (disponibile solo con la catena simulata) e puntare.
4. Account staff per la console `/ops/` e per `/admin/`:
```bash
docker compose exec web python manage.py createsuperuser
```
Un operatore non superutente riceve i permessi dall'admin: `view_console` per entrare in `/ops/` e uno per ciascun comando (`pause_after_round`, `suspend_new_bets`, `suspend_withdrawals`).
5. Verifica a mano su telefono e desktop: [checklist-verifica-sito.md](checklist-verifica-sito.md). Test automatici: `python -m pytest`.
6. Spegnere: `docker compose down` (i dati restano in `data/db`).
---
> **Nota (migrazione a Django).** Il resto di questa guida descrive il vecchio stack FastAPI, non più nel `docker-compose.yml`.
poterla avviare. Il server gira sempre in Docker; il venv serve solo a test, migrazioni da generare e script una tantum. Per come avviarla poi ogni volta, vedi
| `XPRV_ENCRYPTION_KEY_FILE` | Percorso del file che contiene la chiave simmetrica che cifra a riposo la master xprv del server (`./secrets/xprv_encryption.key`, cartella `0700`, file `0600`; nel container è montato come secret). **Perdere questa chiave significa perdere per sempre l'accesso ai fondi di tutti gli utenti.** | `mkdir -p secrets && chmod 700 secrets && python -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())" > secrets/xprv_encryption.key && chmod 600 secrets/xprv_encryption.key` |
Dal venv: `PYTHONPATH=. python scripts/generate_master_key.py`, con `MASTER_KEY_PATH=./data/keys/master.xprv.enc` in `.env`, così lo script scrive esattamente il file che legge il container.