Prérequis d’installation

Système

OS : Ubuntu 22.04+ (ou Debian 12).
CPU/RAM : min. 4 vCPU / 8 Go RAM pour un petit déploiement (ingestion Docling + Torch est coûteux lors du build).
Disque : 50 Go libres recommandés (images + cache build + volumes MinIO/Qdrant/Postgres).

Docker Engine ≥ 24 + plugin Docker Compose (v2).
- Vérifier : docker --version, docker compose version.
Python 3.10+ (pour le wizard) + pip.
(Option) curl, git, make pour les utilitaires.

Connexion Internet active (téléchargement images + appels LLM).
Par défaut bind sur 127.0.0.1. Ports à réserver :
- UI HOST_UI_PORT (3000), API HOST_API_PORT (8000), Gateway HOST_GATEWAY_PORT (8100), Postgres POSTGRES_HOST_PORT (5432), Qdrant HOST_QDRANT_PORT (6333), MinIO API/Console HOST_MINIO_API_PORT/HOST_MINIO_CONSOLE_PORT (9000/9001), Redis HOST_REDIS_PORT (16379).
Si reverse-proxy : prévoir les FQDN (ex. rag.example.com, gateway.example.com, console-minio.example.com) + certificats TLS.
Nom de domaine : choisir le sous‑domaine qui exposera Nexus (ex. rag.auroramind.fr) et l’URL publique associée (https://...).

OpenAI API key (embeddings).
- https://platform.openai.com/api-keys
OpenRouter API key (runtime).
- https://openrouter.ai/keys
OpenRouter Usage API key (usage/cost).
- https://openrouter.ai/keys
- Si vous n’avez pas de clé dédiée, réutilisez la clé runtime.
FreeCurrency API key (taux EUR).
- https://freecurrencyapi.com/
Secrets internes : le wizard peut en générer (JWT, Postgres, MinIO, Gateway, Fernet). Garder un endroit sûr pour les stocker.

Compte utilisateur avec droits Docker (ou root).
Le fichier .env ne doit pas être dans Git. Stockage recommandé : /etc/aurora/prod.env (chmod 600) ou un secret manager.