Introducción
En esta lección aprenderás a instalar las dos herramientas fundamentales de nuestra infraestructura de IA: Portainer (gestor de contenedores) y Traefik (proxy reverso para gestionar dominios).
Paso 1: Ejecutar el Setup de Orion Design
Obtener el comando de instalación
- Ve a la página oficial de Orion Design: oriondesign.art.br
- Copia el comando de setup haciendo clic en «Copiar código de setup»
- Pega el comando en tu terminal del servidor
- Presiona Enter
Nota importante: También te proporcionaremos este comando para que simplemente lo copies y pegues.
bash <(curl -sSL setup.oriondesign.art.br)
Proceso de instalación inicial
- El sistema actualizará primero todos los paquetes de Ubuntu
- Después desplegará el menú de aplicaciones disponibles
- Este proceso toma entre 1-2 minutos dependiendo de tu conexión
⚠️ Advertencia sobre Ubuntu: Aunque aparezca un aviso recomendando Ubuntu 20.04, es mejor usar Ubuntu 22.04 ya que la versión 20 pronto perderá soporte.
Aceptar términos
- Aparecerá una pantalla pidiendo aceptar los términos de licencia MIT
- Escribe Y y presiona Enter
Paso 2: Navegar por el menú de aplicaciones
Explorar las opciones disponibles
- Página 1: Muestra las primeras 45 aplicaciones
- Página 2: Para ver el resto, escribe P2 y presiona Enter
- Regresar: Escribe P1 para volver a la página 1
Actualmente hay más de 70 aplicaciones disponibles, todas open source.
Entender los requisitos de recursos
Cada aplicación muestra números verdes (ej: 1/1, 2/2) que indican:
- Primer número: CPUs mínimas requeridas
- Segundo número: GB de RAM mínimos requeridos
Ejemplos:
- Chatwoot: 2 CPUs + 2 GB RAM
- N8n: 2 CPUs + 2 GB RAM
- Supabase: 2 CPUs + 4 GB RAM
💡 Recomendación: Tu servidor debe tener mínimo 8 GB de RAM para instalaciones exitosas.
Paso 3: Configurar DNS en tu dominio
Si no tienes generada la Zona DNS del dominio que vas a usar
- Accede a tu panel de contabo y ve al apartado «DNS Zone Management»
- Ve a «Create new DNS zone» escribe el nombre del dominio y elige el servidor al que va a apuntar
- Importante: Tienes que cambiar las DNS del dominio a las de contabo
Administrar un dominio en contabo
- Accede a tu panel de contabo y ve al apartado «DNS Zone Management»
- Busca el dominio que quieres administrar y pulsa en el icono de editar
Crear registro tipo A (solo una vez)
- Ve a la sección Registros
- Agrega un registro tipo A con:
- Nombre:
workstation
(o el nombre que prefieras) - Apunta a: La IP de tu servidor
- Nombre:
- Presiona Agregar registro
Crear registro CNAME para Portainer
- Agrega un registro tipo CNAME con:
- Nombre:
devportainer
(evita usar solo «portainer» para prevenir bloqueos de Google) - Apunta a:
workstation.tudominio.com
- Nombre:
- Presiona Agregar registro
¿Por qué esta estructura DNS?
- Ventaja: Si cambias de servidor, solo modificas 1 registro (tipo A) con la IP del nuevo servidor
- Sin esta estructura: Tendrías que cambiar múltiples registros tipo A para cada aplicación
- Resultado: Administración más eficiente
Paso 4: Instalar Portainer y Traefik
Seleccionar la instalación
- En el menú de Orion, escribe 01 (Traefik + Portainer)
- Presiona Enter
Configurar los datos solicitados
Dominio de Portainer:
- Ingresa:
dev-portainer.tudominio.com
- Presiona Enter
Usuario de Portainer:
- Recomendado:
admin
- Presiona Enter
Contraseña:
- Debe incluir mayúsculas, minúsculas y caracteres especiales
- Presiona Enter
Nombre del servidor:
- Ingresa el nombre que desees (ej: nombre del cliente o agencia)
- Presiona Enter
Nombre de la red:
- Ingresa un nombre para la red interna (ej:
jerocuevasNet
) - Presiona Enter
Email de contacto:
- Ingresa tu email principal
- Presiona Enter
Verificar y confirmar
- Revisa que todos los datos sean correctos
- Si hay errores, presiona N para corregir
- Si todo está bien, presiona Y para continuar
Paso 5: Completar la instalación
Proceso automático
- Orion instalará automáticamente Traefik y Portainer
- El proceso toma entre 3-5 minutos máximo
- No cierres la terminal durante este proceso
Acceso a Portainer
- Una vez terminado, aparecerán los datos de acceso
- ¡IMPORTANTE! Tienes máximo 5 minutos para acceder
- Copia la URL, usuario y contraseña proporcionados
- Accede inmediatamente a tu dominio configurado
Verificar instalación exitosa
- Ingresa tus credenciales en Portainer
- Si accedes correctamente, verás el dashboard
- Ve a la sección Stacks
- Deberías ver Portainer y Traefik instalados
Próximos pasos
Con Portainer y Traefik instalados correctamente, ya tienes la base de tu infraestructura lista. Desde Portainer podrás:
- Gestionar todas las aplicaciones futuras
- Monitorear recursos del servidor
- Administrar contenedores Docker
En la siguiente lección instalaremos las primeras aplicaciones de IA sobre esta base sólida.
Consejos importantes
✅ Haz esto:
- Guarda todos tus datos de acceso en un lugar seguro
- Usa nombres descriptivos para tus registros DNS
- Mantén tu servidor con mínimo 8 GB RAM
❌ Evita esto:
Tardar más de 5 minutos en acceder a Portainer por primera vez
Usar nombres exactos de aplicaciones en DNS
Cerrar la terminal durante instalaciones