Binaire

Exécutez Stib directement sur votre machine en tant que binaire natif — sans Docker, sans conteneur. Cela vous offre des performances maximales, un contrôle direct sur le processus serveur et la configuration la plus simple possible.

Prérequis

Plateforme	Architecture	Version minimum
macOS	ARM64 (Apple Silicon) uniquement	macOS 11.0 (Big Sur)
Linux	x64, ARM64	Toute distribution récente
Windows	x64, x86, ARM64	Windows 10+

WARNING

macOS Intel (x86_64) n'est pas supporté. Il n'existe pas de binaire pré-compilé pour les Mac Intel. Seul Apple Silicon (M1/M2/M3/M4) est pris en charge.

TIP

Vous ne savez pas quelle méthode d'installation choisir ? Le binaire est idéal si vous souhaitez exécuter Stib directement sans conteneur. Pour les déploiements conteneurisés, consultez Docker ou Docker Compose.

Téléchargement

Téléchargez la dernière version pour votre plateforme depuis la page de téléchargement.

Plateforme	Architecture	Artefact
macOS	ARM64 (Apple Silicon)	`stib-server-macos-arm64.dmg`
Linux	x64	`stib-server-linux-x64.deb` / `stib-server-linux-x64.tar.gz`
Linux	ARM64	`stib-server-linux-arm64.deb` / `stib-server-linux-arm64.tar.gz`
Windows	x64	`stib-server-windows-x64.msi`
Windows	x86	`stib-server-windows-x86.msi`
Windows	ARM64	`stib-server-windows-arm64.msi`

Installation macOS

Téléchargez stib-server-macos-arm64.dmg
Ouvrez le DMG et glissez stib-server dans votre dossier Applications
Lancez l'application depuis Applications ou exécutez depuis le terminal :

bash

open /Applications/stib-server.app

WARNING

Au premier lancement, macOS Gatekeeper peut bloquer l'application car elle n'est pas encore notarisée par Apple. Pour l'autoriser :

Clic droit sur l'application → Ouvrir, puis cliquez Ouvrir dans la boîte de dialogue
Ou allez dans Réglages Système → Confidentialité et sécurité et cliquez Ouvrir quand même

TIP

Une icône dans la barre des menus apparaît automatiquement lorsque Stib est en cours d'exécution, vous donnant un accès rapide au statut du serveur, aux logs, au redémarrage et à l'arrêt.

Installation Linux

Option 1 — Paquet .deb (Debian/Ubuntu)

bash

sudo dpkg -i stib-server-linux-x64.deb

Le binaire est installé dans /usr/bin/stib-server.

Option 2 — Installation manuelle (toute distribution)

bash

tar xzf stib-server-linux-x64.tar.gz
sudo cp stib-server /usr/local/bin/
sudo chmod +x /usr/local/bin/stib-server

INFO

Pour les systèmes ARM64, utilisez les variantes arm64 des paquets : stib-server-linux-arm64.deb ou stib-server-linux-arm64.tar.gz.

Installation Windows

Téléchargez stib-server-windows-x64.msi (ou la variante x86/ARM64)
Exécutez l'installeur MSI — il installe dans Program Files\stib-server\, ajoute Stib au PATH système et crée un raccourci dans le menu Démarrer

WARNING

Au premier lancement, Windows SmartScreen peut afficher un avertissement car le binaire n'est pas encore signé numériquement. Cliquez sur Plus d'infos → Exécuter quand même pour continuer.

Lancer le serveur

Démarrez le serveur depuis un terminal :

macOSLinuxWindows (CMD)

# Si installé via DMG
open /Applications/stib-server.app

# Ou exécuter le binaire directement
/Applications/stib-server.app/Contents/MacOS/stib-server

stib-server

stib-server

Le serveur écoute sur 0.0.0.0:50505 et crée automatiquement un répertoire data/ dans le répertoire de travail. L'interface web est accessible à l'adresse http://localhost:50505.

TIP

Une icône dans la barre système apparaît automatiquement sur macOS, Windows et Linux (avec un serveur d'affichage), offrant un accès rapide au statut du serveur, aux logs, au redémarrage et à l'arrêt.

Variables d'environnement

Variable	Description	Défaut	Requis
`STIB_ENCRYPTION_KEY`	Clé de chiffrement des identifiants (AES-256-GCM, 32 octets en hexadécimal)	—	Uniquement si vous utilisez le chiffrement des identifiants
`STIB_SERVER_ORIGIN`	URL de base pour les redirections OIDC (ex. `https://stib.example.com`)	`http://localhost:50505`	Uniquement pour OIDC SSO
`STIB_UPDATE_URL`	Point de terminaison du vérificateur de mises à jour	—	Optionnel
`RUST_LOG`	Niveau de journalisation (`info`, `debug`, `warn`)	`info`	Optionnel

Pour générer une clé de chiffrement valide :

bash

openssl rand -hex 32

Données persistantes

Stib stocke toutes ses données dans un répertoire data/ relatif à l'emplacement d'exécution du serveur :

data/
├── stib.db          # Base de données SQLite (créée automatiquement)
├── logs/            # Logs rotatifs quotidiens (7 fichiers max)
├── backups/         # Sauvegardes de la base de données
└── attachments/     # Pièces jointes des cartes

Exécuter en tant que service

Linux — systemd

L'archive tar.gz inclut un fichier stib-server.service. Pour configurer le démarrage automatique :

bash

sudo cp stib-server.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now stib-server

Gérer le service :

bash

sudo systemctl status stib-server    # Vérifier le statut
sudo systemctl restart stib-server   # Redémarrer
sudo systemctl stop stib-server      # Arrêter
journalctl -u stib-server -f         # Voir les logs

macOS — launchd

D'abord, créez un lien symbolique vers un emplacement fixe pour que launchd puisse le trouver :

bash

sudo mkdir -p /usr/local/bin
sudo ln -sf /Applications/stib-server.app/Contents/MacOS/stib-server /usr/local/bin/stib-server

Créez le plist LaunchAgent dans ~/Library/LaunchAgents/com.stib.server.plist :

xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.stib.server</string>
    <key>ProgramArguments</key>
    <array>
        <string>/usr/local/bin/stib-server</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <true/>
    <key>StandardOutPath</key>
    <string>/tmp/stib-server.out.log</string>
    <key>StandardErrorPath</key>
    <string>/tmp/stib-server.err.log</string>
    <key>EnvironmentVariables</key>
    <dict>
        <key>RUST_LOG</key>
        <string>info</string>
    </dict>
</dict>
</plist>

Charger et démarrer le service :

bash

launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.stib.server.plist
launchctl kickstart -k gui/$(id -u)/com.stib.server

Pour arrêter et décharger :

bash

launchctl bootout gui/$(id -u)/com.stib.server

Vérifier l'installation

Vérifiez que Stib est en cours d'exécution :

bash

curl http://localhost:50505/api/health

Réponse attendue :

json

{"data":{"status":"ok"}}

Puis ouvrez http://localhost:50505 dans votre navigateur pour accéder à l'interface web.

Mise à jour

Téléchargez le nouveau binaire ou installeur pour votre plateforme
Arrêtez le serveur en cours d'exécution (systemctl stop stib-server, launchctl bootout gui/$(id -u)/com.stib.server, ou Ctrl+C)
Remplacez le binaire (ou exécutez le nouvel installeur)
Redémarrez le serveur — les migrations de base de données s'exécutent automatiquement

TIP

Vos données sont en sécurité — la base de données SQLite et tous les fichiers dans data/ sont préservés lors des mises à jour. Par précaution, sauvegardez data/stib.db avant de mettre à jour.

Étapes suivantes

TIP

Consultez le guide de Configuration pour configurer votre compte administrateur, l'authentification OIDC et personnaliser votre instance.

Binaire ​

Prérequis ​

Téléchargement ​

Installation macOS ​

Installation Linux ​

Option 1 — Paquet .deb (Debian/Ubuntu) ​

Option 2 — Installation manuelle (toute distribution) ​

Installation Windows ​

Lancer le serveur ​

Variables d'environnement ​

Données persistantes ​

Exécuter en tant que service ​

Linux — systemd ​

macOS — launchd ​

Vérifier l'installation ​

Mise à jour ​

Étapes suivantes ​

Binaire

Prérequis

Téléchargement

Installation macOS

Installation Linux

Option 1 — Paquet .deb (Debian/Ubuntu)

Option 2 — Installation manuelle (toute distribution)

Installation Windows

Lancer le serveur

Variables d'environnement

Données persistantes

Exécuter en tant que service

Linux — systemd

macOS — launchd

Vérifier l'installation

Mise à jour

Étapes suivantes