Installer SystemBuddy

Vous aurez reçu un courriel contenant votre clé de licence et deux téléchargements : le serveur (le moteur SystemBuddy et le portail Web où votre équipe se connecte) et l'agent de bureau (installé sur les PC des employés). Voici toute la configuration, de A à Z.

1 · Ce qu'il vous faut d'abord

Une machine Windows ou Linux sur votre réseau pour héberger le serveur (2 Go de mémoire vive ou plus suffisent amplement pour commencer).
PostgreSQL 14 ou plus récent installé dessus (ou accessible depuis cette machine). SystemBuddy y stocke tout. La liste complète des versions prises en charge se trouve plus bas.
Les deux téléchargements de votre courriel de licence, et la clé elle-même.

2 · Installer le serveur

Exécutez le programme d'installation du serveur SystemBuddy que vous avez téléchargé. Il installe le serveur, l'enregistre comme service Windows et met tout en place.
Ouvrez appsettings.Production.json et indiquez votre chaîne de connexion PostgreSQL, ainsi qu'une Jwt:Key unique et aléatoire (32 caractères ou plus). Le serveur refuse de démarrer en production tant qu'une vraie clé n'est pas définie.
Sur la page HTTPS et accès, choisissez comment les navigateurs joignent le serveur (voir plus bas). L'installation ne signale une réussite qu'une fois que la vérification de santé répond par l'adresse que vous avez choisie.
Démarrez le service SystemBuddy (le programme d'installation le propose à la fin). Au premier démarrage, il crée automatiquement le schéma de sa base de données.

Options HTTPS

SystemBuddy lui-même n'écoute que sur http://127.0.0.1:3000. Le programme d'installation inclut un petit service de bordure épinglé (« SystemBuddy Edge », bâti sur Caddy) qui termine le TLS devant lui, s'exécute sous son propre compte de service et ouvre les ports 80 et 443 dans le pare-feu Windows. Rien n'est téléchargé pendant l'installation. Choisissez un mode :

Automatique (Let's Encrypt) : pour un nom DNS public qui pointe vers le serveur, avec les ports 80 et 443 accessibles depuis Internet. Les certificats sont émis et renouvelés automatiquement; un courriel facultatif reçoit les avis d'expiration.
Votre propre certificat : vous fournissez un fichier PFX et son mot de passe, ou un certificat PEM (avec sa chaîne) et une clé privée. Le renouvellement vous revient : déposez le nouveau fichier et relancez l'installation, ou utilisez edge\Apply-EdgeConfig.ps1.
Interne seulement : aucun accès Internet requis. La bordure crée une autorité de certification locale et exporte C:\ProgramData\SystemBuddy\caddy\root.crt; poussez cette racine vers vos PC par stratégie de groupe (ou certutil -addstore Root) et les navigateurs feront confiance à l'adresse interne.
Aucun : conservez le comportement actuel, soit HTTP en boucle locale seulement, et vous placez votre propre mandataire inverse devant.

Le nom d'hôte que vous saisissez doit correspondre à l'URL de l'application. Si la bordure ne peut pas devenir prête (par exemple si le domaine ne se résout pas encore), l'installation la retire et le serveur continue de fonctionner sur le port en boucle locale, de sorte que vous pouvez corriger le DNS et simplement relancer le programme d'installation.

3 · Première connexion

Naviguez jusqu'à l'adresse du serveur. L'assistant de configuration initiale apparaît une seule fois et vous demande de créer votre compte administrateur. Aucun mot de passe par défaut n'existe où que ce soit dans SystemBuddy, et c'est voulu.

4 · Activer votre licence

Connectez-vous avec cet administrateur → Paramètres → Licence.
Réglez l'URL du serveur de licences à https://licensing.systembuddy.net et enregistrez.
Collez votre clé de licence et activez. Les fonctionnalités de votre forfait se déverrouillent immédiatement, et le serveur revalide discrètement selon un horaire par la suite.

Vos données ne quittent jamais votre réseau. L'activation ne fait qu'échanger la clé et les droits avec notre service de licences.

5 · Déployer l'agent

Exécutez le programme d'installation de l'agent sur chaque PC d'employé (ou déployez-le avec vos outils habituels).
Dans les paramètres de l'agent, réglez l'URL du serveur à l'adresse de votre serveur SystemBuddy et connectez-vous.
Les machines s'enregistrent automatiquement comme actifs au premier contact; activez « Démarrer automatiquement à l'ouverture de session » pour qu'il soit toujours accessible d'un clic dans la barre d'état système.

6 · Vous êtes en service

Les employés demandent de l'aide depuis l'agent; les TI traitent les billets, les actifs, les mises à jour et les sessions depuis le portail. Les mises à jour arrivent dans Paramètres → Mises à jour logicielles lorsque nous les publions. Les mises à jour du serveur s'appliquent avec le script inclus, et les mises à jour de l'agent se déploient sur vos appareils depuis le portail.

Plateformes prises en charge

SystemBuddy est conçu pour les serveurs que vous avez déjà, y compris les plus anciens. Exécutez un second nœud de serveur à partir du même programme d'installation et vous obtenez la haute disponibilité : l'assistant de configuration vous guide dans la base de données en attente et le répartiteur de charge.

Windows Server pour le serveur SystemBuddy : 2012 R2, 2016, 2019, 2022 et 2025. Le programme d'installation n'exige aucun module complémentaire sur aucun d'eux : il utilise netsh et sc.exe directement, sans dépendre d'une version plus récente de PowerShell.
PostgreSQL pour la base de données : 14, 15, 16, 17 et 18.
Nœuds de base de données Linux : entièrement pris en charge, et recommandés si vous voulez que la base de données bascule automatiquement. Un nœud de base de données Windows fonctionne aussi, la promotion étant faite par vous ou par le script que l'assistant imprime.

Windows Server 2012 R2 n'est plus pris en charge par Microsoft (le soutien étendu a pris fin en octobre 2023) et ne reçoit donc plus de correctifs de sécurité du système d'exploitation. SystemBuddy s'y installe et s'y exécute encore, et l'installation ne vous bloquera pas, mais elle avertit, et il vaut la peine de planifier le déplacement de ce nœud vers un Windows plus récent.

Coincé ?

Écrivez à orders@systembuddy.net avec le premier bloc de votre clé de licence et l'endroit où vous êtes coincé, et nous répondons rapidement.