Installation Docker

Le fichier docker-compose.yml du dépôt tire l'image publiée. C'est le chemin homelab par défaut.

git clone https://github.com/lucas-lepajollec/SwissKnife.git
cd SwissKnife
docker compose up -d

SwissKnife répond sur http://localhost:2501. Le service s'appelle swissknife, le conteneur swissknife, l'image ghcr.io/lucas-lepajollec/swissknife:latest.

Le mapping observé est 2501:8080 : l'hôte expose 2501, Nginx écoute 8080 dans le conteneur.

Comportement du conteneur

Le Dockerfile observé impose :

• build Node 20 Alpine, puis Nginx unprivileged 1.27 Alpine ;
• utilisateur nginx (non root) à l'exécution ;
• healthcheck wget sur http://127.0.0.1:8080/ à l'intérieur du conteneur ;
• en-têtes de sécurité dans nginx.conf, dont COOP/COEP pour FFmpeg WASM.

Le Compose homelab n'ajoute pas de volume, ni de système de fichiers en lecture seule.

Construire depuis les sources

Pour valider le checkout courant plutôt que l'image publiée :

docker compose -f docker-compose.build.yml up -d --build

Même port hôte 2501, même healthcheck. Détails des tags : Image GHCR.

Utiliser un autre port hôte

Le côté droit reste 8080. Modifiez uniquement la valeur gauche :

services:
  swissknife:
    ports:
      - "8088:8080"

Contrôler le démarrage

docker compose ps
docker compose logs --tail 100 swissknife

Le conteneur doit devenir healthy. Si le port 2501 est déjà pris, changez le mapping hôte puis relancez.

Arrêter

docker compose stop

Pour retirer le conteneur :

docker compose down

Aucune donnée applicative n'est perdue : SwissKnife n'en persiste pas. Voir Désinstallation.