Configuration requise
Ce qu'il faut installer avant de lancer votre pack, avec ou sans Docker.
Pour le pack Full Stack
Ce que contient chaque pack
| Pack | Applications incluses dans le téléchargement | Fonctionne seul |
|---|---|---|
| Full Stack | API, site public, tableau de bord de l'agence | Oui, les trois ensemble |
| Site public | Site public | Non : il faut que l'API Velra soit lancée |
| Tableau de bord de l'agence | Tableau de bord de l'agence | Non : il faut que l'API Velra soit lancée |
| API backend | API | Oui, en servant uniquement l'API |
Un pack à application unique n'inclut pas les autres applications. Le site et le tableau de bord lisent tout depuis l'API Velra, et le code de l'API ne se trouve que dans les packs Full Stack et API backend.
Avec Docker
- Docker Desktop sous macOS ou Windows, ou Docker Engine avec le plugin Compose sous Linux, avec Docker Compose 2.24 ou plus récent, ce qu'inclut tout Docker Desktop actuel ;
docker compose versionaffiche la vôtre. La pile complète démarre avec une seule commandedocker compose, etdocker-compose.ymlne litback-end/.envque s'il existe, un réglage que les anciennes versions de Compose rejettent. - Une connexion internet pour le premier build, qui télécharge les images de base et les dépendances.
- Rien d'autre : Docker fournit Node.js, et la base de données est un fichier SQLite dans un volume Docker.
Avec Docker
- Docker Desktop sous macOS ou Windows, ou Docker Engine sous Linux. Votre application a son propre
Dockerfile; Compose n'est pas nécessaire. - Une connexion internet pour le premier build, qui télécharge l'image de base et les dépendances.
Sans Docker
- Node.js 22 ou plus récent, la version que déclare chaque application dans
engines. Les images Docker tournent sous Node.js 24. Vérifiez la vôtre avecnode -v. - Yarn 4, via Corepack. Lancez
corepack enableune fois ; chaque application épingle sa propre version de Yarn danspackageManager, doncyarnchoisit la bonne. Si votre Node.js n'a pas Corepack (Node.js 25 et plus récent ne l'inclut plus), installez-le d'abord avecnpm install -g corepack. - Aucun package global.
Base de données
Aucun serveur de base de données. L'API utilise SQLite par défaut et yarn seed crée le fichier pour vous ; Docker utilise aussi SQLite. MySQL est pris en charge par un changement de configuration, pas de code.
Ports
Chaque application écoute sur un port local fixe. Assurez-vous que rien d'autre ne les utilise, ou, avec Docker, déplacez-en un avec SITE_PORT, ADMIN_PORT ou API_PORT dans un .env à côté de docker-compose.yml.
| Application | Port |
|---|---|
| API | 8000 |
| Site public | 3030 |
| Tableau de bord de l'agence | 3031 |
Port
Le site écoute sur le port 3030 et attend l'API sur 8000. Assurez-vous que rien d'autre ne les utilise.
Port
Le tableau de bord écoute sur le port 3031 et attend l'API sur 8000. Assurez-vous que rien d'autre ne les utilise.
Port
L'API écoute sur le port 8000 et accepte par défaut le site depuis 3030 et le tableau de bord depuis 3031. Assurez-vous que rien d'autre n'utilise le port 8000.
Une API à connecter
Votre application n'a aucune donnée propre. Il faut que l'API Velra soit lancée et alimentée, avec son adresse définie dans son .env ou passée en argument de build. L'API est vendue comme un pack à part, l'API backend, et fait partie du Full Stack.
Services optionnels
Aucun de ces services n'est nécessaire pour lancer l'agence en local. Chacun s'active avec ses variables dans le .env de l'API ; une variable laissée en commentaire garde sa fonctionnalité désactivée.
| Service | Sans lui |
|---|---|
| Cloudflare R2 ou un autre bucket compatible S3 | Les fichiers téléversés sont stockés sur le disque de l'API (avec Docker, dans le volume de données), et l'API sert elle-même les photos du seed. |
| Une clé IA de Google Gemini, OpenAI ou DeepSeek, une seule suffit | L'assistant IA indique qu'il a besoin d'une clé de fournisseur et liste les trois qu'il accepte, et rien n'est facturé. Tout le reste fonctionne. |
| Une clé Google Gemini, pour le studio de mise en scène | Le studio de mise en scène IA indique qu'il en a besoin et ne génère rien, même quand l'assistant tourne avec une clé OpenAI ou DeepSeek. |
| Une clé pour le serveur MCP | POST /api/mcp refuse toutes les requêtes. |
Il n'y a aucun service d'e-mail ou de paiement à configurer : les demandes et les demandes de visite arrivent sous forme de notifications dans le tableau de bord.
Cartes
Les cartes du tableau de bord affichent des tuiles OpenFreeMap, et la recherche de lieu de l'éditeur de bien utilise le service public Photon. Les deux demandent une connexion Internet, sans clé ni compte ; aucun ne garantit sa disponibilité, et vous pouvez les faire pointer vers vos propres services.