Prima di iniziare

• Prerequisiti e versioni indicati nel README della release effettiva; PowerShell 7 e Docker per i percorsi container.
• Ambiente autorizzato, backup disponibile e parametri di produzione deliberati prima dell'esposizione.

Passo dopo passo

1. Leggi README, operations e runbook Production della versione da distribuire. Non usare il profilo demo come configurazione produttiva.
2. Esegui la configurazione prevista senza sostituire .env o chiavi esistenti. Un segreto mancante richiede diagnosi e recupero, non una rigenerazione per aggirare l'errore.
3. Per la demo segui scripts/install.ps1. Per produzione usa compose.production.yaml e il runbook, con TLS, storage privato, proxy fidati e segreti esterni.
4. Al primo accesso di un'installazione nuova usa il segreto bootstrap, inserisci cliente, prima azienda e amministratore con nuova password da 14 a 256 caratteri. La concessione operativa è una scelta esplicita.
5. Per aggiornare segui scripts/update.ps1 e controlla backup, build, readiness e un'operazione reale. Se la build fallisce verifica che la versione precedente continui a essere disponibile.

Limiti e recupero

• Una readiness positiva non dimostra login, email, SSO o checkout funzionanti.
• Nel PC condiviso usare slot e launcher Docker prescritti; la guida non autorizza arresti o modifiche ad altre installazioni.

Before you start

• Prerequisites and versions listed in the actual release README; PowerShell 7 and Docker for container workflows.
• An authorised environment, an available backup and approved production parameters before exposure.

Step by step

1. Read the release README, operations guide and Production runbook. Do not treat the demo profile as production configuration.
2. Run the intended configuration procedure without replacing existing .env files or keys. Missing secrets require diagnosis and recovery, not regeneration to bypass failure.
3. For a demo, follow scripts/install.ps1. For production, use compose.production.yaml and its runbook, with TLS, private storage, trusted proxies and external secrets.
4. On the first access to a new installation, supply the bootstrap secret and enter customer, first company and administrator with a new password of 14 to 256 characters. Granting operational privileges is an explicit choice.
5. For an update, follow scripts/update.ps1 and inspect backup, build, readiness and a real operation. If building fails, check that the previous version remains available.

Limits and recovery

• Readiness alone proves neither login, email, SSO nor checkout operation.
• On the shared PC, use the required slots and Docker launcher; this guide authorises no changes to other installations.