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'espace de travail | Oui, les trois ensemble |
| SaaS Website | Site public | Oui, sur ses données d'exemple intégrées ; le formulaire de contact et le paiement des licences atteignent une API Northstack dès que vous le pointez vers une |
| Workspace Dashboard | Tableau de bord de l'espace de travail | Oui, sur ses données d'exemple intégrées dans le navigateur ; les vrais comptes et données demandent une API Northstack |
| API backend | API | Oui, en servant uniquement l'API |
Un pack à application unique n'inclut pas les autres applications. 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.13 ou une version 22 plus récente, ou Node.js 24.11 ou plus, pour l'API et le full stack (l'
enginesde l'API est^22.13.0 || >=24.11.0). Le site et le tableau de bord seuls fonctionnent avec Node.js 22.9 ou plus. Les images Docker utilisent Node.js 24. Vérifiez la vôtre avecnode -v. - Yarn 4, via Corepack. Lancez
corepack enableune fois ; chaque application fixe Yarn 4.8.1 danspackageManageret fournit sonyarn.lock, si bien queyarn installinstalle exactement les versions avec lesquelles elle a été testée. Si votre Node.js n'a pas Corepack (Node.js 25 et plus ne l'incluent 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'espace de travail | 3031 |
Port
Le site écoute sur le port 3030. Relié à une API, il l'attend sur 8000 sauf si vous lui donnez une autre adresse. Vérifiez que rien d'autre ne les utilise.
Port
Le tableau de bord écoute sur le port 3031. Relié à une API, il l'attend sur 8000 sauf si vous lui donnez une autre adresse. Vérifiez 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 besoin de rien d'autre pour démarrer : sans adresse d'API, elle fonctionne sur ses données d'exemple intégrées. Pour travailler avec de vrais comptes, des paiements et des e-mails, il lui faut l'API Northstack, dont vous définissez l'adresse dans son .env ou que vous passez comme argument de build. L'API est vendue comme pack à part, le Backend API, et fait partie du Full Stack.
Services optionnels
Aucun de ces services n'est nécessaire pour lancer Northstack en local. Chacun s'active par ses variables dans le .env de l'API ; une variable laissée vide garde sa fonctionnalité désactivée.
| Service | Sans lui |
|---|---|
| Un compte Stripe | Change plan, dans la page Billing du tableau de bord, ouvre le paiement test intégré, et le paiement des licences du site ouvre son propre paiement test. Aucun ne débite personne, si bien que les deux parcours fonctionnent de bout en bout. |
| Une application REST PayPal | PayPal dans le paiement des licences passe par le même paiement test. |
| Un serveur SMTP pour les e-mails | Les invitations, les réinitialisations de mot de passe et les reçus de licence sont écrits dans le journal de l'API, liens compris, au lieu d'être envoyés. |
| Un bucket Cloudflare R2 | Les fichiers et images des projets sont stockés sur le disque de l'API elle-même (avec Docker, dans le volume de données). |
| Une clé IA de Google Gemini, OpenAI ou DeepSeek, une seule suffit | Chaque personne peut ajouter sa propre clé pour un fournisseur dans l'assistant, gardée dans son navigateur ; sans elle, l'assistant ne peut pas répondre. Tout le reste fonctionne. |
| 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. Northstack ne facture aucune taxe de lui-même : configurez la fiscalité de votre pays avant d'encaisser de vrais paiements.