En esta lección vamos a dar el paso más emocionante: instalar Orion Design en tu servidor VPS.
Orion Design es como una «navaja suiza» que nos permite instalar decenas de aplicaciones de inteligencia artificial y automatización con un solo clic. He actualizado esta guía a la versión 2.8, que es la más estable y potente hasta la fecha. ¡Vamos a ello!
Videotutorial Paso a Paso:
Aquí tienes el video completo donde realizo el proceso en tiempo real para que no te pierdas ningún detalle.
1. Preparativos antes de empezar
Antes de pegar el primer comando, asegúrate de cumplir con estos dos puntos que vimos en lecciones anteriores:
- Tu servidor listo: Debes tener un VPS con Debian 11 (o Ubuntu 22.04) totalmente limpio, sin paneles de control instalados.
- Conexión activa: Abre Termius (o tu terminal favorita) y conéctate a tu servidor como usuario
root.
2. Instalando el Framework (El momento mágico)
El proceso es increíblemente rápido. Solo tienes que seguir estos pasos:
- Entra en la web oficial de los desarrolladores:
OrionDesign.art.br. (Está en portugués, pero no te preocupes, el código es universal). - Busca el script de instalación (el código de setup) y cópialo. Te lo dejo aquí también:
bash <(curl -sSL setup.oriondesign.art.br) - En tu terminal, pega el código y pulsa Intro.
- El sistema te preguntará si aceptas las políticas de uso. Escribe la letra y y pulsa Intro.
¡Listo! En unos segundos verás aparecer un menú numerado. Ese es el panel de control de Orion Design.
3. Explorando el Menú de Aplicaciones
Lo que tienes ante tus ojos es una maravilla. Tienes acceso a más de 90 aplicaciones open-source que, de otra forma, serían un «dolor de muelas» instalar una a una.
Aquí puedes instalar herramientas como n8n, Chatwoot, Evolution API o Supabase de forma gratuita. Solo pagas por tu servidor, el software es a coste cero.
Cómo navegar por el panel:
Como hay tantas aplicaciones, están divididas en páginas. Aquí tienes los comandos básicos para moverte:
| Comando | Acción |
| p1 | Ir a la página 1 de aplicaciones. |
| p2 | Ir a la página 2 (más de 45 apps adicionales). |
| p3 | Ir a la página 3 (donde están las últimas novedades). |
| comando | Muestra herramientas de mantenimiento (reiniciar servicios, SSL, etc.). |
| Instalar una Aplicación | simplemente escribe su número y pulsa Intro |
| exit | Salir del menú de Orion y volver a la terminal normal. |
Truco de experto: Si no encuentras una aplicación, usa el buscador de tu terminal (Control + F o Comando + F) y escribe el nombre (por ejemplo: «n8n»). Así la localizarás al instante en la lista.
4. El Menú Secreto de «Comando» (¡Un Salvavidas!)
Orion Design tiene una sección oculta con herramientas súper útiles. Para acceder a ella, en el menú principal, escribe comando y pulsa Intro.
Aquí encontrarás funciones que te pueden salvar de muchos problemas:
portainer.restart: Si se te pasan los 5 minutos iniciales para configurar Portainer, este comando lo reinicia y te da otros 5 minutos.traefik.restart: Si tienes problemas con los certificados SSL (HTTPS), reiniciar Traefik a menudo lo soluciona.limpar: Este comando limpia la caché de Docker (imágenes y volúmenes que no se usan), liberando espacio en tu servidor.
Explora estos comandos porque son increíblemente potentes.
5. Ojo a los Recursos de tu Servidor
Al lado de cada aplicación verás unos números (ejemplo: 2 y 2). Esto significa que esa app necesita 2 CPUs y 2 GB de RAM para funcionar bien.
- No te vuelvas loco instalando todo: Instala solo lo que necesites.
- Suma los requisitos: Si instalas varias apps que piden mucha RAM y tu servidor solo tiene 12 GB, podrías saturarlo. Por eso en la lección anterior te recomendé un servidor potente.
6. ¿Qué pasa si algo falla?
Si una instalación se queda colgada o una aplicación no abre:
- Entra en el menú escribiendo comando.
- Prueba a reiniciar el servicio específico (como Portainer o Traefik).
- Mi recomendación de oro: Si ves que todo se complica y nada funciona, lo más sano es reinstalar el sistema operativo desde el panel de tu VPS (Contabo/Hostinger) y empezar de cero. Se tarda menos y te aseguras de que todo quede perfecto.