Saltar al contenido principal
Esta guía cubre la instalación estándar de Zylon para entornos con acceso completo a internet. El sistema descargará automáticamente todas las dependencias requeridas, imágenes de contenedores y modelos de IA. Lista de Prerrequisitos:
  • Máquina Linux limpia (Ubuntu 22/24) que cumpla con los requisitos de hardware
  • Acceso root y SSH a la máquina
  • Un nombre de dominio para Zylon (por ejemplo, zylon.company.com)
  • Capacidad para reiniciar la máquina cuando sea necesario
  • La máquina tiene curl instalado
  • Acceso completo y sin restricciones a internet en la máquina objetivo
  • El firewall permite conexiones salientes a registros de Docker y repositorios de paquetes
  • Ya sea:
    • Puertos 80 y 443 abiertos para la generación automática de certificados SSL de Let’s Encrypt, O
    • Certificado SSL válido listo para configuración manual

​
Instalando Zylon

1

Instalar Zylon CLI

Tiempo estimado: 2 minLa CLI de Zylon acelerará el tiempo necesario para tener todo listo, se encargará de instalar controladores, actualizar Zylon y configurar el sistema. Para instalarla, conéctate por SSH a la máquina donde quieres instalar Zylon y ejecuta:
# ssh <user>@<host-ip>
sudo curl -sL get.zylon.ai | sh
Verifica la instalación:
sudo zylon-cli version
Se requiere acceso root para las operaciones de la CLI, ya que gestiona dependencias y configuraciones a nivel de sistema.
2

Verificar requisitos mínimos de Zylon

Asegúrate de que tu máquina cumple con los requisitos de hardware para Zylon.Para validar automáticamente si tu instalación cumple con los requisitos mínimos, ejecuta:
sudo zylon-cli preflight --network --fresh-system -v
Resuelve cualquier problema reportado antes de proceder con la instalación. No podrás continuar hasta que todas las comprobaciones previas pasen.
¿Tienes problemas con la conectividad de red? Considera cambiar a una Instalación Semi-Airgap o Instalación Airgap.
Zylon requiere que todas las comprobaciones pasen antes de proporcionar soporte de instalación.
3

Configurar Zylon

Tiempo estimado: 10minZylon se configura mediante un archivo YAML ubicado en /etc/zylon/zylon-conf.yaml.Generar Configuración InicialUsa la CLI para generar un archivo de configuración inicial:
sudo zylon-cli config init
Esto abre un prompt interactivo que te guía a través de las opciones de configuración.
Si por alguna razón te quedas atascado durante el prompt interactivo, puedes omitirlo añadiendo la bandera -y para auto-generar una configuración por defecto:
sudo zylon-cli config init -y
Después necesitarás editar manualmente /etc/zylon/zylon-conf.yaml para establecer tu configuración deseada basándote en la sección de configuración manual.
Si ejecutaste sudo zylon-cli config init, toda la configuración está establecida. Revisa /etc/zylon/zylon-conf.yaml para confirmar la configuración. Puedes obtener más información sobre qué configuraciones son requeridas en la sección Configuración Manual.
Si necesitas volver a ejecutar el asistente de configuración, ejecuta:
sudo zylon-cli config init --force
Puedes
Ver Configuración Actual
sudo cat /etc/zylon/zylon-conf.yaml
Puedes editar el archivo de configuración directamente usando tu editor de texto preferido (por ejemplo, nano, vim):
# Elige uno de los siguientes comandos:
sudo nano /etc/zylon/zylon-conf.yaml
sudo vim /etc/zylon/zylon-conf.yaml
Para información detallada sobre todas las opciones de configuración disponibles, consulta la Guía de Configuración.
4

Instalar Zylon

Tiempo estimado: 15min a 1hora, dependiendo del rendimiento del sistema y velocidad de red.Ejecuta el comando de instalación con tu versión deseada:
sudo zylon-cli list-versions
# Elige tu versión deseada de la lista
sudo zylon-cli install <version>
Reemplaza <version> con tu versión objetivo (por ejemplo, 1.50.0).Qué se InstalaEl proceso de instalación maneja:
  • Dependencias del sistema (gcc, git, etc.)
  • Distribución de Kubernetes (k0s)
  • Controladores NVIDIA y CUDA (si aplica)
  • Runtime de contenedores y herramientas (kubectl, helm)
  • Imágenes de contenedores de Zylon
  • Modelos de IA de tu configuración
  • Generación de certificados SSL (si usas Let’s Encrypt)
5

Crear Organización

Tiempo estimado: 5 minDespués de que Zylon esté instalado y en funcionamiento, crea tu organización y cuenta de administrador root.Prepara la InformaciónNecesitarás:
  • Nombre de organización: El nombre de tu empresa o equipo (se puede cambiar más tarde)
  • Contraseña de administrador: Contraseña segura para el administrador root (se puede cambiar más tarde)
    • Usa caracteres alfanuméricos debido a limitaciones de codificación con símbolos especiales
  • Regex de correo electrónico: Patrón para permitir automáticamente que los usuarios se unan
    • Para correos name@company.com, usa: .*@company\.com
    • Para SSO (Microsoft Entra, Google), puedes usar: .*
Ejecuta el Comando Seed
sudo zylon-cli seed \
  --org-name "Mi Organización" \
  --admin-password "contraseña-segura" \
  --email-regex ".*@tuempresa\.com"
El comando esperará si Zylon no está completamente listo.
Ejecutar el comando seed BORRARÁ TODOS LOS DATOS. Solo ejecútalo una vez durante la configuración inicial de Zylon.
Credenciales de Inicio de SesiónDespués de hacer el seed, usa estas credenciales para iniciar sesión:
Usuario: admin@zylon.ai
Contraseña: [la contraseña que estableciste]
El correo electrónico del administrador root siempre es admin@zylon.ai y no se puede cambiar.
Después del primer inicio de sesión, puedes crear administradores adicionales y configurar la autenticación SSO.
6

Configurar SSL (Opcional)

Tiempo estimado: 10 min
Omite este paso si usas certificados automáticos de Let’s Encrypt (por defecto para instancias públicas).
Para despliegues en VPN o nube privada, necesitas instalar manualmente certificados SSL.Eliminar Generación Automática de CertificadoEdita /etc/zylon/zylon-conf.yaml y elimina estas líneas:
certManagerAnnotations:
  cert-manager.io/cluster-issuer: "letsencrypt-prod"
Prepara los Archivos de CertificadoKubernetes requiere que el certificado se divida en dos archivos:
  • tls.crt - El archivo de certificado
  • tls.key - El archivo de clave privada
Convertir desde PFX (si aplica):Si tienes un archivo .pfx, conviértelo:
openssl pkcs12 -in <tu-certificado.pfx> -clcerts -nokeys -out tls.crt
openssl pkcs12 -in <tu-certificado.pfx> -nocerts -out tls.key
Importar Certificado en Kubernetes
# Elimina cualquier certificado existente
sudo k0s kubectl delete secret tls zylon-tls --ignore-not-found -n zylon

# Importa tu certificado
sudo k0s kubectl create secret tls zylon-tls \
  --key tls.key \
  --cert tls.crt \
  -n zylon

# Verifica la creación
sudo k0s kubectl describe secret zylon-tls -n zylon
Aplicar CambiosRecarga la configuración de Zylon:
sudo zylon-cli sync
VerificarAccede a tu instancia de Zylon en https://zylon.tu-empresa.com y confirma:
  • La conexión usa HTTPS
  • El navegador muestra un certificado válido
  • No aparecen advertencias de certificado
La renovación del certificado debe hacerse manualmente repitiendo este proceso con archivos de certificado actualizados.

​
Actualizando Zylon

Las actualizaciones siguen el mismo proceso que la instalación: 
sudo zylon-cli list-versions
# Elige tu versión deseada de la lista
sudo zylon-cli install <new-version>
Alternativamente, puedes actualizar directamente a la última versión usando el comando de actualización: 
sudo zylon-cli upgrade

​
Migrando a Online

Si tienes una instalación existente de Zylon (semi-airgap o airgap) y quieres migrarla a un entorno completamente online, sigue esta guía. Este proceso preserva tus datos y configuración, mientras realiza la transición a operación online.
La migración difiere de la instalación nueva:
  • Tu configuración y datos existentes serán preservados
  • La organización y usuarios ya existen
Para migrar una instalación existente de Zylon (Semi-Airgap, o Airgap) a una instalación Online, sigue estos pasos:
  1. Asegurar conectividad: Verifica que la máquina objetivo tenga acceso completo a internet.
  2. Actualizar configuración: Ejecuta sudo zylon-cli config init --force para actualizar la configuración para operación online.
  3. Refrescar configuración: Ejecuta sudo zylon-cli sync para aplicar los nuevos ajustes de configuración.
  4. Verificar operación: Confirma que todos los servicios funcionan correctamente con acceso a internet.

​
Próximos Pasos

Después de completar la instalación, considera los siguientes próximos pasos para optimizar tu despliegue de Zylon: