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`).
Nodo e Fulcrum in regtest stanno nella cartella `plm-regtest` accanto al repository (`docker compose up -d` lì); il sito non li avvia. I test sotto `tests/integration/` si agganciano a loro e **si saltano** se non rispondono. Per default cercano l'RPC su `http://127.0.0.1:18332` (credenziali da `plm-regtest/node/palladium.conf`) e Fulcrum su `127.0.0.1:50001`; si cambiano con `PLM_REGTEST_RPC_URL`, `PLM_REGTEST_RPC_USER`, `PLM_REGTEST_RPC_PASSWORD`, `PLM_REGTEST_CONF` e `PLM_REGTEST_ELECTRUM`.
```bash
python scripts/regtest.py status # catena, altezza, saldo del portafoglio del nodo, Fulcrum
python scripts/regtest.py mine 10 # mina 10 blocchi
python scripts/regtest.py fund rplm1… 5 # manda 5 PLM a un indirizzo e mina un blocco
python -m pytest tests/integration # i test sulla catena vera
```
Lo script e i test rifiutano di agire su una catena che non sia regtest.
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.