Aller à l'article
Aniq-UI

TicketoryLancer Ticketory en local

Lancer Ticketory en local

Installez et démarrez chaque application avec Node.js et Yarn, un terminal par application.

Pour le pack Full Stack

DockerRecommandéInstallation manuelle

Avant de commencer : installez Node.js 22 ou plus récent et lancez corepack enable une fois (sous Node.js 25 et plus récent, qui n'inclut plus Corepack, lancez d'abord npm install -g corepack). Aucun serveur de base de données n'est nécessaire.

Voir la configuration requise

Ouvrez chaque terminal là où les commandes ci-dessous l'attendent : dans ticketory-full-stack pour le full stack, ou à côté du dossier de l'application pour un pack d'une seule application.

ApplicationDossierAdresse
APIback-endlocalhost:8000Local
Site publicstorefrontlocalhost:3030Local
Tableau de bord organisateuradmin-dashboardlocalhost:3031Local

Démarrez l'API en premier : les deux frontends lisent toutes leurs données à partir de l'API.

Démarrez l'API

  1. Installez et configurez

    .env.example fonctionne tel quel pour le développement local : SQLite sur le port 8000.

    Terminal
    corepack enable
cd back-end
yarn install
cp .env.example .env
    Un problème ?

  2. Créez la base de données

    yarn seed vérifie que chaque image d'exemple est présente sous public/media, puis crée database.sqlite, ses tables et quatre organisateurs d'exemple, chacun avec son espace de travail : 29 permissions, les rôles Propriétaire, Gestionnaire, Finance et Contrôle des billets, 9 lieux, 36 événements (22 sur le site), 1 145 commandes, 14 comptes d'équipe et un participant avec huit commandes. Il se termine en affichant les identifiants de connexion du propriétaire et du participant. Les dates suivent le jour où vous lancez la commande. Le relancer n'ajoute aucune ligne et ne réinitialise jamais un mot de passe, mais il remet les quatre rôles intégrés à leurs permissions par défaut.

    Terminaldans back-end
    yarn seed

  3. Démarrez le serveur

    Terminaldans back-end
    yarn dev

    Résultat attendu: localhost:8000/api/healthLocal répond avec "status":"ok" et "database":"up".

    Un problème ?

Démarrez l'API

  1. Installez et configurez

    .env.example fonctionne tel quel pour le développement local : SQLite sur le port 8000.

    Terminal
    corepack enable
cd ticketory-backend
yarn install
cp .env.example .env
    Un problème ?

  2. Créez la base de données

    yarn seed vérifie que chaque image d'exemple est présente sous public/media, puis crée database.sqlite, ses tables et quatre organisateurs d'exemple, chacun avec son espace de travail : 29 permissions, les rôles Propriétaire, Gestionnaire, Finance et Contrôle des billets, 9 lieux, 36 événements (22 sur le site), 1 145 commandes, 14 comptes d'équipe et un participant avec huit commandes. Il se termine en affichant les identifiants de connexion du propriétaire et du participant. Les dates suivent le jour où vous lancez la commande. Le relancer n'ajoute aucune ligne et ne réinitialise jamais un mot de passe, mais il remet les quatre rôles intégrés à leurs permissions par défaut.

    Terminaldans ticketory-backend
    yarn seed

  3. Démarrez le serveur

    Terminaldans ticketory-backend
    yarn dev

    Résultat attendu: localhost:8000/api/healthLocal répond avec "status":"ok" et "database":"up".

    Un problème ?

Démarrez le site public

Dans un deuxième terminal :

  1. Installez et configurez

    Le .env copié fait pointer le site vers l'API sur le port 8000.

    Terminal
    cd storefront
yarn install
cp .env.example .env

  2. Démarrez l'application

    Terminaldans storefront
    yarn dev

    Résultat attendu: localhost:3030Local ouvre le site en anglais avec les événements d'exemple ; l'arabe est sur /ar.

    Un problème ?

Démarrez le site public

L'API ne fait pas partie de ce pack. Démarrez-la en premier ; le .env copié l'attend sur http://localhost:8000/api.

  1. Installez et configurez

    Si votre API tourne ailleurs, définissez NEXT_PUBLIC_API_BASE_URL dans .env avec son adresse, /api compris.

    Terminal
    corepack enable
cd ticketory-website
yarn install
cp .env.example .env
    Un problème ?

  2. Démarrez l'application

    Terminaldans ticketory-website
    yarn dev

    Résultat attendu: localhost:3030Local ouvre le site avec les événements de votre API ; l'arabe est sur /ar.

    Un problème ?

Démarrez le tableau de bord organisateur

Dans un troisième terminal :

  1. Installez et configurez

    Le .env copié fait pointer le tableau de bord vers l'API et ses notifications en direct sur le port 8000.

    Terminal
    cd admin-dashboard
yarn install
cp .env.example .env

  2. Démarrez-le et connectez-vous

    yarn dev copie d'abord le worker de la bibliothèque de cartes dans public/maplibre/, puis démarre le tableau de bord.

    Terminaldans admin-dashboard
    yarn dev

    Résultat attendu: localhost:3031Local ouvre le formulaire de connexion. Connectez-vous avec owner@example.test et le mot de passe DemoOnly!2026.

    Un problème ?

Démarrez le tableau de bord organisateur

L'API ne fait pas partie de ce pack. Démarrez-la en premier ; le .env copié l'attend sur http://localhost:8000/api.

  1. Installez et configurez

    Si votre API tourne ailleurs, définissez dans .env NEXT_PUBLIC_API_BASE_URL (avec /api) et NEXT_PUBLIC_WEBSOCKET_BASE_URL (sans) avec son adresse.

    Terminal
    corepack enable
cd ticketory-dashboard
yarn install
cp .env.example .env
    Un problème ?

  2. Démarrez-le et connectez-vous

    Terminaldans ticketory-dashboard
    yarn dev

    Résultat attendu: localhost:3031Local ouvre le formulaire de connexion. Connectez-vous avec owner@example.test et le mot de passe DemoOnly!2026, qu'accepte une API remplie avec les données d'exemple.

    Un problème ?

Autres ports

Sans Docker, les ports sont fixés dans les fichiers. Les scripts dev et start du site, dans package.json, passent -p 3030, et ceux du tableau de bord passent -p 3031 : changez le nombre à cet endroit pour en déplacer un, puis ajoutez la nouvelle adresse à CORS_ORIGIN dans le .env de l'API, et définissez-y STOREFRONT_URL si le site a bougé, ou FRONTEND_URL si c'est le tableau de bord. Pour déplacer l'API, définissez PORT, PUBLIC_MEDIA_URL et PUBLIC_API_URL dans son .env avec le même nombre, ainsi que NEXT_PUBLIC_API_BASE_URL dans les deux frontends (et NEXT_PUBLIC_WEBSOCKET_BASE_URL du tableau de bord).

Build de production

Les mêmes dossiers, construits une fois puis démarrés. Commencez par régler le .env de l'API pour la production : avec NODE_ENV=production, l'API ne modifie jamais les tables au démarrage, et elle refuse de démarrer tant que JWT_SECRET est vide ou encore à la valeur de l'exemple, ou tant que CORS_ORIGIN est vide.

Le .env de l'API
NODE_ENV=production
JWT_SECRET=paste-the-generated-secret-here
CORS_ORIGIN=http://localhost:3030,http://localhost:3031
FRONTEND_URL=http://localhost:3031
STOREFRONT_URL=http://localhost:3030
PUBLIC_API_URL=http://localhost:8000
PUBLIC_MEDIA_URL=http://localhost:8000/media

Générez le secret avec node -e "console.log(require('crypto').randomBytes(48).toString('hex'))". Puis, dans le dossier de l'API, construisez-la, créez ses tables une fois, et démarrez-la. yarn seed:prod ajoute les organisateurs d'exemple et leurs comptes ; yarn db:sync:prod à sa place crée des tables vides sans compte.

Terminal
yarn build
yarn seed:prod
yarn start:prod

Build de production des frontends

Dans le dossier de chaque frontend, lancez le build une fois puis démarrez. Le site répond sur 3030 et le tableau de bord sur 3031.

Terminal
yarn build
yarn start

Les frontends compilent leur .env au moment du build : relancez donc yarn build après l'avoir modifié. Avant de déployer quoi que ce soit de public, lisez le guide de déploiement.

Repartir de données de démonstration neuves

Arrêtez l'API, puis, dans le dossier de l'API, supprimez le fichier de la base de données et recréez-la avec les données de démonstration. Cela supprime tout ce que vous avez créé.

Terminal
rm -f database.sqlite* && yarn seed

Dans PowerShell :

Terminal
Remove-Item database.sqlite*; yarn seed

Étapes suivantes

Cette page vous a-t-elle aidé ?

Vérifié sur la version 2026-10-31

Bloqué sur une étape ?

Trouvez une solution avant de tout recommencer.

Dépannage

Préférences des Cookies

Nous utilisons des cookies pour améliorer votre expérience de navigation, analyser le trafic du site et personnaliser le contenu. En cliquant sur "Accepter Tout", vous consentez à notre utilisation des cookies pour l'analyse et la publicité personnalisée.