Démarrer
Prérequis
Logiciel, ports et décisions à préparer avant l'installation.
Installation Docker recommandée
- Docker Engine et Docker Compose v2 ;
- accès en ligne de commande avec le droit de lancer des conteneurs ;
- port TCP
2501libre sur l'hôte, ou un autre port hôte choisi ; - aucune donnée persistante à provisionner : SwissKnife n'écrit pas de volume applicatif.
Développement depuis les sources
- Node.js 22, comme déclaré par le champ
enginesdupackage.jsonproduit ; - npm 10 ou ultérieur, avec le lockfile du dépôt (
npm ci).
Décisions à prendre
| Question | Choix recommandé |
|---|---|
| Comment installer ? | docker-compose.yml (image GHCR) pour une instance ; docker-compose.build.yml pour valider un checkout |
| Quel port ? | hôte 2501 par défaut, sur toutes les interfaces ; utilisez 127.0.0.1:2501:2501 pour limiter à localhost |
| Accès distant ? | le Compose par défaut est déjà joignable sur le LAN ; placez un reverse proxy HTTPS avant de quitter un réseau de confiance ; conservez COOP/COEP |
| Démo publique ? | utilisez l'URL officielle plutôt que d'exposer votre instance |
Vérifier Docker Compose
docker version
docker compose version