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 organisateur | Oui, les trois ensemble |
| Ticketing Website | Site public | Non : il faut que l'API Ticketory tourne |
| Organiser Dashboard | Tableau de bord organisateur | Non : il faut que l'API Ticketory tourne |
| API backend | API | Oui, en servant uniquement l'API |
Un pack d'une seule application n'inclut pas les autres. Le site et le tableau de bord lisent tout depuis l'API Ticketory, et le code de l'API n'est que dans les packs Full Stack et Backend API.
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 organisateur | 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 pas de données propres. Il lui faut l'API Ticketory en marche et remplie, dont vous indiquez l'adresse dans son .env ou comme argument de build. L'API est vendue comme un pack à part, le Backend API, et fait partie du Full Stack.
Services optionnels
Aucun de ces services n'est nécessaire pour lancer Ticketory 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 |
|---|---|
| Un compte Stripe ou PayPal | Le paiement propose Test payment, qui marque une commande comme payée sans déplacer d'argent, si bien que tout le parcours fonctionne. Les billets gratuits n'ont jamais besoin de fournisseur. |
| Un compte Resend pour l'envoi d'e-mails | Chaque e-mail (billets, codes d'inscription, réinitialisations de mot de passe, nouvelles de remboursement, rappels d'événement) est écrit dans le journal de l'API au lieu d'être envoyé. |
| Cloudflare R2 ou un autre bucket compatible S3 | Les fichiers envoyé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 images d'exemple. |
| Une clé IA de Google Gemini, OpenAI ou DeepSeek, une seule suffit | L'assistant IA d'événements indique qu'il lui faut 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 lieux | Le studio IA de lieux indique qu'il en faut une 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. |
Chaque service payant vous facture sur votre propre compte chez ce fournisseur. Ticketory ne prélève aucune taxe lui-même : configurez la fiscalité de votre pays avant d'encaisser de vrais paiements.
Cartes
Les cartes du tableau de bord affichent les tuiles OpenFreeMap, et la recherche de lieux de l'éditeur de lieux utilise le service public Photon. Les deux demandent une connexion Internet, sans clé ni compte ; aucun ne promet sa disponibilité, et vous pouvez les pointer vers vos propres services.