diff --git a/docs/DEPLOY-VPS.md b/docs/DEPLOY-VPS.md index 1a532a64..f1826a9f 100644 --- a/docs/DEPLOY-VPS.md +++ b/docs/DEPLOY-VPS.md @@ -69,6 +69,122 @@ nano .env # ou vim | `CERTBOT_DOMAIN1` | `prediqo.redirectme.net` | | `SMTP_*` / `EMAIL_FROM` | Envoi d’emails (vérification compte, reset mot de passe) | +### Générer ou régénérer les secrets + +Exécutez ces commandes sur le VPS (ou en local, puis collez **uniquement** dans `.env` — ne les partagez jamais). Chaque secret doit être **unique** et différent des exemples du dépôt. + +#### `ENCRYPTION_KEY` (64 caractères hex) + +```bash +# Linux / macOS / Git Bash (OpenSSL) +openssl rand -hex 32 + +# Ou avec Node (partout où node est installé) +node -e "console.log(require('crypto').randomBytes(32).toString('hex'))" +``` + +Collez le résultat dans `.env` : + +```env +ENCRYPTION_KEY=…64 hex chars… +``` + +> Si des hot wallets existent déjà en base, ne changez pas `ENCRYPTION_KEY` sans suivre la rotation documentée (`deploy/ENCRYPTION_KEY_ROTATION.md`). Sinon les clés chiffrées deviennent illisibles. + +#### `PLATFORM_MNEMONIC` (24 mots BIP39) + +Depuis le dossier `backend` du dépôt (où le paquet `bip39` est installé) : + +```bash +cd /chemin/vers/games_app/backend +node -e "console.log(require('bip39').generateMnemonic(256))" +``` + +Collez la **ligne entière** (24 mots séparés par des espaces) : + +```env +PLATFORM_MNEMONIC=word1 word2 word3 … word24 +``` + +- Pas de virgules, pas de retours à la ligne, pas de guillemets. +- Ne réutilisez **jamais** un mnémonique de testnet / Shasta en mainnet. +- Changer le mnémonique = nouvelles adresses de dépôt et nouveau hot wallet. Les fonds déjà envoyés aux anciennes adresses ne sont récupérables qu’avec l’**ancien** mnémonique. + +Après un premier mnémonique + `ENCRYPTION_KEY` valides (stack déjà démarrée une fois) : + +**Sur le VPS (Docker)** — depuis la racine du dépôt (là où se trouve `docker-compose.yml` et `.env`) : + +```bash +cd ~/projects_repository/games-project # adaptez le chemin +sudo docker compose run --rm --no-deps backend node dist/scripts/seedHotWallets.js +``` + +Ne lancez **pas** `npm run seed-hot-wallets` sur l’hôte du VPS : ce script utilise `ts-node`, absent en prod. Utilisez le JS compilé dans le conteneur `backend` (comme pour les migrations). + +**En local (dev, sans Docker)** : + +```bash +cd backend +npm install # si besoin (inclut ts-node) +npm run seed-hot-wallets +``` + +Une seule fois suffit : si le hot wallet existe déjà, le script affiche `Skipping` et ne recrée rien. + +#### `JWT_SECRET` et `INITIAL_SETUP_TOKEN` + +Deux valeurs **différentes**, chacune ≥ 32 caractères aléatoires : + +```bash +# JWT_SECRET +node -e "console.log(require('crypto').randomBytes(48).toString('hex'))" + +# INITIAL_SETUP_TOKEN (relancer pour une autre valeur) +node -e "console.log(require('crypto').randomBytes(48).toString('hex'))" +``` + +```env +JWT_SECRET=… +INITIAL_SETUP_TOKEN=… +``` + +`INITIAL_SETUP_TOKEN` ne sert qu’à créer le premier administrateur sur `/setup`. Une fois un admin créé, il n’est plus nécessaire pour le quotidien ; vous pouvez le régénérer ou le laisser. + +#### Mot de passe PostgreSQL (`DATABASE_PASSWORD` / `POSTGRES_PASSWORD`) + +Choisissez un mot de passe long et aléatoire. Dans `DATABASE_URL`, encodez les caractères spéciaux : + +| Caractère | Dans l’URL | +|-----------|------------| +| `@` | `%40` | +| `!` | `%21` | +| `#` | `%23` | +| `%` | `%25` | +| `/` | `%2F` | +| `:` | `%3A` | + +Exemple si le mot de passe réel est `Japhni82@@!` : + +```env +DATABASE_PASSWORD=Japhni82@@! +POSTGRES_PASSWORD=Japhni82@@! +DATABASE_URL=postgresql://postgres:Japhni82%40%40%21@host.docker.internal:5432/games_platform_db +``` + +Le backend préfère `DATABASE_PASSWORD` pour la connexion ; l’URL encodée évite les erreurs avec d’autres outils. **Ne** mettez **pas** le littéral `DATABASE_PASSWORD` dans l’URL : ce n’est pas interpolé. + +#### `TRON_API_KEY` + +1. Compte sur [TronGrid](https://www.trongrid.io/) (e-mail + confirmation). +2. À l’activation, **Skip** le lien wallet (TronLink n’est pas requis pour Prediqo). +3. Dashboard → Create API Key → coller dans `.env` : + +```env +TRON_API_KEY=… +``` + +Après toute modification de secrets dans `.env`, redémarrez la stack (`sudo npm run phase-b:up` ou équivalent). Rebuild `prediqo-web` uniquement si vous changez les `VITE_*`. + ### Configuration SMTP (Gmail) L’erreur `535-5.7.8 Username and Password not accepted` signifie que **Gmail refuse le mot de passe SMTP**. Le mot de passe normal du compte Gmail **ne fonctionne pas** : il faut un **mot de passe d’application**.