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 a la línea de comandos con permiso para ejecutar contenedores;
- puerto TCP
2502libre en el host, u otro puerto de host elegido; - ningún dato persistente que aprovisionar: AstroGuide no escribe en un volumen de aplicación.
Desarrollo desde el código fuente
- Node.js
22.x; - npm 10 o posterior, con el lockfile del repositorio;
npm ci --include=optional: algunas dependencias nativas son opcionales, pero resultan útiles para la compilación.
Decisiones que tomar
| Pregunta | Opción recomendada |
|---|---|
| ¿Cómo instalar? | imagen GHCR para una instancia; Compose local para validar un checkout |
| ¿Qué puerto? | 2502 por defecto; cambia solo el valor izquierdo del host |
| ¿Acceso remoto? | red local o proxy inverso; AstroGuide no tiene autenticación |
| ¿Demo pública? | usa la URL oficial en lugar de exponer tu instancia |
Comprobar Docker Compose
docker version
docker compose version