Instalación en un servidor

Qubix se ejecuta en su propio servidor — un único comando de instalación levanta toda la infraestructura (base de datos, backend, servidor web, herramientas auxiliares). Solo necesita un servidor Linux limpio con acceso SSH y Docker.

Requisitos del servidor

El instalador verifica el servidor antes de comenzar y se detiene si la máquina es claramente insuficiente. El mínimo recomendado es:

Recurso	Mínimo recomendado
CPU	4 vCPU
RAM	8 GB
Disco	20 GB SSD o HDD

Estos son los valores que recomienda el instalador; por debajo de ellos el sistema funciona, pero advierte que ClickHouse será lento en los días de mayor carga. Hay un límite absoluto de 10 GB de disco libre — por debajo de ese umbral la instalación se detiene.

El tipo de disco no influye en el servicio de tráfico — tanto SSD como HDD funcionan, y HDD permite ahorrar; SSD solo acelera los informes del panel de administración a grandes volúmenes. 20 GB son más que suficientes para empezar: caben la plataforma más miles de creativos, y el historial de tráfico apenas pesa. Para saber exactamente cuánto tráfico y cuántos creativos caben en un disco determinado, consulte Cómo elegir su servidor.

Algunos requisitos imprescindibles:

• Un servidor Linux de 64 bits (VPS/VDS o máquina dedicada), no un ordenador personal ni un alojamiento compartido.
• Docker con el plugin docker compose (V2). El antiguo docker-compose independiente (V1) no está soportado — el instalador lo detecta y se detiene.
• HTTPS de salida para que el servidor pueda descargar las imágenes de Qubix.

Un servidor limpio

Instale Qubix en un servidor dedicado exclusivamente a él. La infraestructura necesita que los puertos 80, 443 (y 8443 para la opción Cloudflare) estén libres. Si otro servidor web ya los ocupa, libérelos primero o elija la opción Cloudflare más adelante en el asistente.

Instalación

1. Conéctese al servidor por SSH como root.

2. Ejecute el comando de instalación:

   Bash

   curl -sSL https://qubix.pro/install.sh | bash

   (o wget -qO- https://qubix.pro/install.sh | bash)

   

3. El instalador muestra el banner de Qubix, verifica el servidor, hace algunas preguntas (carpeta de instalación, interfaz de red en la que publicar) y luego descarga e inicia la infraestructura. Espere hasta que informe de que todo está en funcionamiento.

No interrumpa el proceso

Deje que el instalador termine. Detenerlo a mitad puede dejar una infraestructura configurada a medias — si ocurre, la forma más segura de recuperarse es eliminar la carpeta de instalación y ejecutar el comando de nuevo en un servidor limpio.

Qué obtendrá

El instalador levanta un pequeño conjunto de contenedores que forman Qubix: la base de datos de analítica, el backend de Qubix, el servidor web y los auxiliares de actualización automática, certificados e inteligencia artificial. No los gestiona manualmente — Qubix los administra por usted.

Finalizar la configuración en el navegador

Cuando la infraestructura esté en marcha, el instalador imprime un enlace como:

http://<su-ip-del-servidor>:7000/install?k=…

Abra ese enlace completo en un navegador (la clave ?k=… es obligatoria). Se abrirá el asistente de configuración, donde elige cómo se accederá a Qubix, introduce su licencia y crea el primer administrador.

El enlace funciona una sola vez

El asistente de configuración solo es accesible hasta que lo finalice. Después de crear el primer administrador, el enlace deja de funcionar — esto es lo esperado. A partir de entonces, iniciará sesión en la dirección propia de su panel.

Próximos pasos

Crear un administrador

Recorra el asistente de configuración: dirección, licencia, administrador.

Descripción general de la interfaz

Cómo está organizado el panel de administración.