Primeros pasos
Requisitos
Software, puertos y decisiones que debes preparar antes de instalar.
Instalación recomendada con Docker
- Docker Engine y Docker Compose v2;
- acceso por línea de comandos con permiso para ejecutar contenedores;
- puerto TCP
2501libre en el host, u otro puerto de host elegido; - ningún almacenamiento persistente que preparar, porque SwissKnife no escribe volúmenes de aplicación.
Desarrollo desde el código fuente
- Node.js 22, según el campo
enginesdelpackage.jsondel producto; - npm 10 o posterior, utilizando el lockfile del repositorio (
npm ci).
Decisiones que debes tomar
| Pregunta | Opción recomendada |
|---|---|
| ¿Cómo instalarlo? | docker-compose.yml con la imagen GHCR para una instancia; docker-compose.build.yml para validar un checkout |
| ¿Qué puerto? | host 2501 de forma predeterminada, en todas las interfaces; usa 127.0.0.1:2501:2501 para limitar a localhost |
| ¿Acceso remoto? | el Compose predeterminado ya es accesible en la LAN; pon un reverse proxy HTTPS antes de salir de una red de confianza; conserva COOP y COEP |
| ¿Demo pública? | utiliza la URL oficial en vez de exponer tu propia instancia |
Comprobar Docker Compose
docker version
docker compose version