Inicio rápido de Coblyn

●  Inicio rapido⏱ 10 minv1.17.0 Release GateÚltima rev · 27 jun 2026

Coblyn v1.17.0 "Release Gate" se instala como un appliance Docker. Esta página sirve para una PoC Web/API sin tocar DHCP/PXE; para producción, sigue la guía completa de instalación y operaciones.

Requisitos minimos

• Sistema operativo — Ubuntu Server 24.04 LTS amd64 o Debian 12 amd64.
• Permisos — Acceso sudo.
• Red — NIC fisica o bridged si vas a probar DHCP/PXE.
• Recursos PoC — 4 vCPU, 8 GB RAM y 60 GB de disco.
• Internet — Necesario para descargar el release, paquetes e imágenes Docker.

Descarga verificada

install -d -m 0700 "$HOME/coblyn-bootstrap"
cd "$HOME/coblyn-bootstrap"
curl --proto '=https' --tlsv1.2 -fSLO \
  https://get.coblyn.gksistemas.es/releases/download/v1.17.0-rc.5/setup.sh
curl --proto '=https' --tlsv1.2 -fSLO \
  https://get.coblyn.gksistemas.es/releases/download/v1.17.0-rc.5/setup.sh.sha256
sha256sum --check setup.sh.sha256
less setup.sh

No ejecutes directamente una respuesta de red con curl | sudo bash. El paso less permite revisar qué se va a ejecutar. El checksum detecta corrupción o una descarga inconsistente. Cada release incluye además un manifiesto Sigstore firmado, pero el canal seguirá marcado como piloto hasta que el bootstrap exija esa verificación y exista un mirror fuera del VPS.

PoC sin DHCP/PXE

Ejecuta el instalador interactivo con el perfil de pruebas:

sudo bash ./setup.sh --release 1.17.0-rc.5 --testing --wizard

El bootstrap instala Coblyn en /opt/coblyn, prepara dependencias, genera secretos seguros y crea el primer administrador mediante entrada oculta. El perfil de pruebas no activa DHCP, PXE ni TFTP.

Validar el nodo

cd /opt/coblyn/coblyn
sudo ./setup.sh doctor
docker compose ps

Si doctor detecta secretos antiguos o placeholders:

sudo ./setup.sh doctor --fix
sudo ./setup.sh doctor

Primer acceso

Abre:

http://<PXE_SERVER_IP>:<WEB_PORT>

El instalador interactivo crea el primer administrador persistente con entrada oculta. Si arrancaste el stack manualmente, ejecuta sudo ./setup.sh admin-bootstrap. La contraseña nunca se guarda en .env.

Siguiente paso

• Storage Hub — Configura un pool NFS o SMB/CIFS desde Storage. No uses el modelo antiguo de NFS_SERVER/NFS_PATH como fuente principal.
• Boot assets — Carga activos de arranque en tftpboot/.
• PXE — Prueba un cliente en la VLAN correcta.
• Backup — Antes de upgrades, ejecuta sudo ./setup.sh backup.

Guia completa

Para firewall, secretos obligatorios, upgrade desde v1.x y baseline Alembic, continua en Instalacion y operaciones.