Northstar · Guide pas à pas

English

Northstar pour Odoo Community

Faites tourner Northstar sur votre propre ordinateur ou votre propre serveur, avec Docker. Sans connexion, et sans connaître Odoo.

Votre installation
Environ 10 minutes la première fois, pour installer Docker une fois.
Northstar prête en
Quelques minutes.

Démarrage rapide

  1. Installez Docker, une fois
    Téléchargez Docker Desktop (gratuit pour un usage personnel, l'enseignement et les petites entreprises) et ouvrez-le jusqu'à ce qu'il affiche Engine running. Sous Linux, installez plutôt Docker Engine.
  2. Téléchargez et décompressez Northstar
    Cliquez sur Télécharger Northstar sur la page Northstar (ou utilisez ce lien direct), puis décompressez le fichier dans un dossier vide. Toutes les versions sont sur la page des versions GitHub. Le zip contient le fichier Docker, la sauvegarde de la base, un README avec le démarrage rapide, la licence et les conditions.
  3. Démarrez-la
    Ouvrez un terminal dans ce dossier, tapez docker compose up et appuyez sur Entrée. Le premier démarrage prend quelques minutes. Quand vous voyez Northstar is ready, ouvrez http://localhost:8069 et connectez-vous avec admin et le mot de passe admin.
Ces mots de passe sont publics. Ils conviennent sur votre propre ordinateur. Avant de mettre Northstar sur un serveur que d'autres personnes peuvent atteindre, changez chaque mot de passe : voir La mettre en ligne plus bas.
Besoin de plus de détails ?

Ce qu'il vous faut

  • Un ordinateur sous Windows 10 ou 11, un Mac (puce Apple ou puce Intel) ou Linux.
  • Environ 3 Go d'espace disque libre et 8 Go de mémoire (RAM). Dans Docker Desktop, laissez au moins 4 Go à Docker.
  • Une connexion internet pour le premier démarrage : Docker télécharge une seule fois Odoo et PostgreSQL.
  • Docker, un programme gratuit qui fait tourner Northstar.
Docker Desktop est gratuit pour un usage personnel, l'enseignement, l'open source non commercial et les entreprises de moins de 250 salariés et de moins de 10 millions de dollars américains de chiffre d'affaires par an. Les plus grandes entreprises ont besoin d'un abonnement Docker payant. Docker Engine sous Linux est gratuit.

Installer Docker

Windows 10 ou 11

  1. Téléchargez Docker Desktop sur docker.com et lancez l'installation.
  2. Laissez Use WSL 2 coché. Cela active WSL 2 pour vous. Redémarrez l'ordinateur quand on vous le demande.
  3. Lancez Docker Desktop une fois et attendez qu'il affiche Engine running.

Mac

  1. Téléchargez Docker Desktop sur docker.com. Choisissez Mac with Apple chip (M1, M2, M3, M4 et suivants) ou Mac with Intel chip. Vous ne savez pas lequel ? Ouvrez le menu Apple, puis À propos de ce Mac.
  2. Ouvrez Docker Desktop une fois et attendez qu'il affiche Engine running.

Linux

  1. Installez Docker Engine et le plugin Compose pour votre distribution : docs.docker.com/engine/install.
  2. Vérifiez avec docker compose version. Docker Compose 2.20 ou plus récent est nécessaire.
  3. Ajoutez-vous au groupe docker (sudo usermod -aG docker $USER, puis fermez et rouvrez votre session), ou mettez sudo devant les commandes ci-dessous.

Télécharger Northstar

  1. Cliquez sur Télécharger Northstar sur la page Northstar. Le fichier s'appelle northstar-odoo20.zip. N'utilisez pas le bouton vert Code, puis Download ZIP, sur GitHub : il ne contient pas la base de données.
  2. Décompressez-le dans un dossier vide. Sous Windows, faites un clic droit sur le fichier et choisissez Extraire tout. Le dossier contient alors docker-compose.yml, le fichier de la base de données, un README, la licence et les sommes de contrôle. Rien d'autre n'est nécessaire.

Démarrer Northstar

  1. Ouvrez un terminal dans ce dossier. Sous Windows, faites un clic droit dans un espace vide du dossier et choisissez Ouvrir dans le Terminal. Sur Mac, ouvrez Terminal, tapez cd , faites glisser le dossier dans la fenêtre et appuyez sur Entrée. Sous Linux, ouvrez un terminal dans ce dossier.
  2. Tapez ceci et appuyez sur Entrée : docker compose up
  3. Patientez. Le premier démarrage prend quelques minutes, et c'est normal. Docker télécharge une seule fois Odoo et PostgreSQL, puis Northstar affiche Restoring Northstar et une ligne Still restoring toutes les 10 secondes. Vous n'avez rien à faire.
  4. Quand vous voyez Northstar is ready, ouvrez http://localhost:8069 dans votre navigateur. Laissez la fenêtre du terminal ouverte tant que Northstar tourne.

Se connecter

Utilisez l'un de ces identifiants :

  • Administrateur : admin avec le mot de passe admin
  • Les quatre utilisateurs des ventes : rachel.donovan@northstar-supply.example, marcus.hale@northstar-supply.example, priya.raman@northstar-supply.example, tomas.kowalski@northstar-supply.example, tous avec le mot de passe northstar
Ces mots de passe sont publics. Ils conviennent sur votre propre ordinateur. Avant de mettre Northstar sur un serveur que d'autres personnes peuvent atteindre, changez le mot de passe de chaque utilisateur.

Northstar n'envoie aucun e-mail : chaque adresse est sur un domaine .example qui ne peut pas recevoir de courrier.

L'arrêter, la relancer, repartir de zéro

  • Arrêter : appuyez sur Ctrl+C dans le terminal, ou lancez docker compose down.
  • Relancer : docker compose up. Les démarrages suivants gardent vos données et s'ouvrent en quelques secondes.
  • Le port 8069 est déjà utilisé ? Lancez NORTHSTAR_PORT=8070 docker compose up (dans PowerShell : $env:NORTHSTAR_PORT=8070; docker compose up), puis ouvrez l'adresse avec 8070.
  • Repartir des données d'origine : docker compose down -v, puis docker compose up. Cela supprime tous les changements que vous avez faits.
  • Une version plus récente : téléchargez à nouveau Northstar, lancez docker compose down -v dans l'ancien dossier, décompressez le nouveau fichier dans un nouveau dossier vide et lancez docker compose up dedans. Nous publions une nouvelle version chaque semaine.
  • Qui peut y accéder : seulement votre propre ordinateur, pas votre réseau.

Une autre façon : la restaurer sans Docker

Le téléchargement contient la base de données sous forme de sauvegarde Odoo standard. Elle se restaure sur tout Odoo 20 Community auto-hébergé :

  1. Décompressez le téléchargement. Ouvrez /web/database/manager sur votre Odoo 20 (par exemple http://localhost:8069/web/database/manager).
  2. Cliquez sur Restore Database, saisissez votre mot de passe maître, choisissez le fichier de la base dans le dossier décompressé (le zip nommé northstar-odoo20.zip), et nommez la base northstar.
  3. Gardez This database is a copy sélectionné, puis cliquez sur Continue.
  4. Ouvrez la nouvelle base et connectez-vous avec l'un des identifiants ci-dessus.

Si le téléversement s'arrête, augmentez la taille maximale de téléversement de votre serveur web ou de votre proxy (par exemple client_max_body_size dans nginx).

Northstar sur votre propre serveur

Le même téléchargement et la même commande, docker compose up -d, fonctionnent sur n'importe quel serveur Linux où Docker est installé (voir Installer Docker Engine). Rien d'autre ne change.

Avant de l'ouvrir à d'autres personnes :

  • Changez le mot de passe de chaque utilisateur.
  • Définissez votre propre mot de passe maître (admin_passwd dans la configuration d'Odoo) et désactivez la liste des bases (list_db = False), pour que personne ne puisse ouvrir le gestionnaire de bases afin d'en copier, d'en restaurer ou d'en supprimer une.
  • Changez le mot de passe de PostgreSQL dans docker-compose.yml, et gardez PostgreSQL hors du réseau.
  • L'inscription publique et la réinitialisation du mot de passe sont déjà désactivées dans Northstar. Laissez-les ainsi, sauf besoin.

L'associer. Pour ajouter une nouvelle journée chaque nuit, lancez docker compose --profile live up -d sur le serveur, puis ouvrez notre page Northstar, cliquez sur Northstar tourne sur un serveur ? Saisissez son code et saisissez le code (voir Northstar Live plus bas).

Utiliser l'IA dessus. Les questions que vous posez dans le chat, ChatGPT ou Claude sont traitées sur notre Northstar hébergé, pas sur votre serveur. Pour interroger votre propre copie, donnez-lui une adresse https publique et connectez-la avec une clé API Odoo.

Nos guides gratuits couvrent le reste :

Si quelque chose ne va pas

  • La restauration a échoué : Northstar affiche une ligne qui dit ce qui a échoué et quoi faire. En général, lancez docker compose down -v, puis relancez docker compose up.
  • La ligne dit que le fichier de la base est endommagé : téléchargez à nouveau Northstar et décompressez-la dans un dossier vide.
  • Cela échoue encore : écrivez à contact@speaktoyourdatabase.com avec la ligne affichée par Northstar.

Northstar Live : gardez-la vivante chaque jour

Northstar Live ajoute chaque nuit une nouvelle journée d'activité à votre téléchargement. Il ne vous faut ni serveur, ni nom de domaine, ni port ouvert.

Votre installation
Environ 5 minutes.
Northstar prête en
Quelques minutes. Les jours manquants depuis la création de votre copie sont ajoutés en arrière-plan.

Démarrage rapide

  1. Démarrez-la avec Live
    Dans le dossier de votre téléchargement Northstar, ouvrez un terminal et lancez docker compose --profile live up -d. C'est le même téléchargement que plus haut : Live en fait partie.
  2. Cliquez sur Associer
    Ouvrez http://localhost:8070 sur cet ordinateur et cliquez sur Associer. Votre navigateur ouvre notre page Northstar.
  3. Confirmez sur notre page
    Connectez-vous (c'est gratuit). Notre page Northstar affiche le code de votre ordinateur : cliquez sur Associer. Vous avez 15 minutes.
Besoin de plus de détails ?

Ce qu'il vous faut

  • Docker installé, comme plus haut (Docker Desktop sous Windows et Mac, Docker Engine avec le plugin Compose sous Linux).
  • 8 Go de mémoire (RAM) et environ 3 Go de disque. Dans Docker Desktop, laissez au moins 4 Go à Docker.
  • Un processeur Intel ou AMD, ou un ARM 64 bits (Apple Silicon, Linux ARM récent).
  • Un compte gratuit sur notre site : vous vous connectez une fois pour associer votre ordinateur.

La mettre en place, en détail

  1. Démarrez-la. Ouvrez un terminal dans le dossier (sous Windows, clic droit dans un espace vide puis Ouvrir dans le Terminal ; sur Mac, tapez cd , faites glisser le dossier et appuyez sur Entrée) et lancez docker compose --profile live up -d. Cela démarre Northstar et Northstar Live ensemble, donc cela marche aussi si vous aviez déjà lancé docker compose up -d. Le premier démarrage télécharge ce dont il a besoin : environ 5 minutes, selon votre connexion.
  2. Cliquez sur Associer. Ouvrez http://localhost:8070 sur cet ordinateur et cliquez sur Associer. Votre navigateur ouvre notre page Northstar avec le code de votre ordinateur.
  3. Confirmez sur notre page. Connectez-vous, puis cliquez sur Associer. Chaque code ne sert qu'une fois, pendant 15 minutes.
  4. Vérifiez. La page de votre ordinateur affiche maintenant Live.

Sur un serveur sans navigateur. Lancez docker compose exec northstar-live northstar-live code : il affiche le code et le lien. Ouvrez le lien dans un navigateur sur le même réseau que le serveur et connectez-vous, ou ouvrez notre page Northstar de n'importe où, cliquez sur Northstar tourne sur un serveur ? Saisissez son code et saisissez le code. Si votre navigateur est sur un autre réseau que le serveur, notre page vous demande de confirmer que c'est votre propre ordinateur.

Vous n'avez aucun fichier à modifier pour l'association. Le seul fichier que vous pouvez toucher est .env, pour changer un port : voir Si quelque chose ne va pas plus bas.

Votre Odoo est sur http://localhost:8069. Connectez-vous avec admin et le mot de passe admin (les quatre utilisateurs des ventes ont le mot de passe northstar). Ces mots de passe sont publics : gardez Odoo sur votre propre ordinateur, comme le fait ce paquet.

Ce qui se passe chaque nuit

  • Chaque nuit, nous ajoutons la journée qui vient de finir : pistes et devis, commandes, livraisons, factures, paiements, achats, ventes au comptoir, ordres de fabrication, projets, congés et présences.
  • Aujourd'hui est toujours vide : la journée est ajoutée après sa fin. Interrogez la semaine dernière ou le mois dernier.
  • Vos propres modifications sont laissées tranquilles.
  • Laissez-la tourner. Si votre ordinateur est en veille ou si Docker est arrêté un moment, les jours manqués sont ajoutés au retour.
  • Si personne n'utilise votre Northstar pendant 30 jours, elle se met en pause. Ouvrir votre Odoo la maintient en marche, et un clic sur Reprendre sur notre page Northstar la remet en route.
  • La page de votre ordinateur (http://localhost:8070) montre si elle est active et quand elle a ajouté une journée pour la dernière fois.

Nous ne pouvons pas lire l'Odoo de votre ordinateur. Les questions que vous posez dans ChatGPT, Claude ou notre chat sont traitées sur notre Northstar hébergé, la même entreprise. Les changements que vous faites à la main dans votre propre Odoo ne sont pas dans ces réponses.

Comment l'arrêter

  • Mettre Northstar Live seul en pause : docker compose stop northstar-live. Odoo continue de fonctionner sans lui, et les jours manqués sont ajoutés à son retour.
  • Tout arrêter : docker compose stop. Relancez avec docker compose --profile live up -d.
  • Dissocier cet ordinateur de votre compte : sur notre page Northstar, cliquez sur Déconnecter cet ordinateur, ou sur votre ordinateur utilisez le bouton de http://localhost:8070 (cochez d'abord la case), ou sans navigateur lancez docker compose exec northstar-live northstar-live unpair. Votre Odoo et vos changements restent, et la page de votre ordinateur affiche un nouveau code.
  • L'associer à un autre compte : dissociez-la d'abord, puis cliquez de nouveau sur Associer et connectez-vous avec l'autre compte.
  • Repartir des données d'origine : docker compose down -v, puis docker compose --profile live up -d. Cela supprime vos changements et l'association : vous l'associez de nouveau avec un nouveau code.

Si quelque chose ne va pas

  • port is already allocated : un autre programme utilise 8069 ou 8070. Copiez .env.example vers .env, changez NORTHSTAR_PORT ou NORTHSTAR_LIVE_PAGE_PORT, puis relancez docker compose --profile live up -d.
  • La page affiche Not connected longtemps : vérifiez votre connexion internet. Au travail, un proxy peut la bloquer.
  • Un nouveau code (il a expiré, ou pour associer à nouveau) : utilisez le bouton de http://localhost:8070.
  • Autre chose : docker compose logs northstar-live montre ce que Northstar Live a fait. Il n'y écrit jamais votre clé, le code d'association ni vos données : vous pouvez l'envoyer à contact@speaktoyourdatabase.com.

Besoin d'aide ? Contactez le support