Docker Compose

Utilisez Compose pour regrouper définition du serveur, volume persistant, montages de dépôts et environnement dans un seul fichier.

services:
  stib:
    image: enixion/stib-server:latest
    restart: unless-stopped
    ports:
      - "50505:50505"
    volumes:
      - stib-data:/data
      - ./projects:/projects
    environment:
      RUST_LOG: info
      # STIB_SERVER_ORIGIN: https://stib.example.com
      # STIB_ENCRYPTION_KEY: ${STIB_ENCRYPTION_KEY}
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:50505/api/health"]
      interval: 30s
      timeout: 5s
      retries: 3

volumes:
  stib-data:

Créez les projets avec des chemins sous /projects. Si vous choisissez un autre chemin conteneur, gardez-le stable pour que les chemins enregistrés restent valides après recréation.

Démarrer et exploiter

docker compose up -d
docker compose ps
docker compose logs -f stib

Arrêter sans supprimer le volume nommé :

docker compose down

Mettre à jour l’image :

docker compose pull
docker compose up -d

Créez une sauvegarde cohérente dans les paramètres Stib avant la mise à jour. docker compose down ne supprime pas le volume stib-data, sauf si vous ajoutez explicitement --volumes.

Reverse proxy

Terminez HTTPS sur le proxy et transmettez HTTP ainsi que les upgrades WebSocket au port conteneur 50505. Pour OIDC, définissez STIB_SERVER_ORIGIN avec l’origine HTTPS publique, sans suffixe /api.

Agents en sandbox

Les conteneurs agent par projet exigent l’accès à l’API Docker et des variables/montages supplémentaires. C’est un choix de déploiement privilégié, absent du fichier minimal ci-dessus. Évaluez les implications de sécurité avant d’exposer le socket Docker.

Suite : Configuration.