Saltar al contenido principal
Versión: 0.4 · actual

Instalar Excubius

Información generalRevisada el 11 de octubre de 2026
Se aplica a:Excubius 0.4Roles: Instalador (administrador de Linux)
PlanesFree · Core · Pro · EnterpriseImplementaciónEn tus servidores

Excubius se ejecuta en un servidor Linux que tú controlas, en tu suscripción de nube o en tu centro de datos. El instalador interactivo revisa el servidor, hace unas pocas preguntas, instala los contenedores y obtiene el certificado. Este artículo enumera lo que necesitas, lo que el instalador pregunta y hace, y a dónde ir para cada tarea posterior.

Antes de empezar​

ElementoRequisito
ServidorRocky Linux 9 o 10 (u otro sistema de la familia RHEL), x86-64, systemd. Al menos 2 vCPU, 4 GiB de memoria y 20 GiB de disco libre; en Azure, Standard_B2ms (2 vCPU, 8 GiB) es un buen punto de partida y se puede redimensionar más adelante. Si tu equipo de nube crea los servidores, consulta Solicitar el servidor de Azure
AccesoUna cuenta con sudo en el servidor, accesible por SSH desde tu estación de trabajo
Red hacia los usuariosPuertos 80 y 443 libres en el servidor y abiertos desde donde las personas usarán Excubius
SalidaHTTPS hacia ghcr.io y docker.io para descargar las imágenes, salvo que uses el paquete sin conexión
Red hacia lo que monitoreasDesde el servidor, el puerto SQL de cada instancia, réplica e IP de listener (y UDP 1434 para instancias con nombre sin puerto fijo), además de HTTPS hacia los puntos de conexión web que pruebes. Nada se conecta al recolector
Paquete del instaladorexcubius-installer-<version>.tar.gz, o el paquete sin conexión con las imágenes incluidas. Los usuarios con sesión iniciada obtienen ambos en Descargas
Inicio de sesiónUn registro de aplicación de Microsoft Entra ID, un cliente OAuth de Google, o ambos. Consulta Configurar proveedores de inicio de sesión
Inicios de sesión de monitoreoInicios de sesión de solo lectura para lo que vayas a monitorear, por ejemplo el inicio de sesión de SQL Server de Requisitos previos para grupos de disponibilidad
CertificadoPara Let's Encrypt, un nombre DNS público que apunte al servidor, o acceso por API a su zona DNS. No es necesario si usas tu propio certificado, uno autofirmado o una puerta de enlace que termina TLS

Cómo funciona la instalación​

Las comprobaciones previas revisan el sistema operativo y su versión, la arquitectura, systemd y dnf, la memoria, las CPU, el disco, que los puertos 80 y 443 estén libres, SELinux, el acceso a los registros de contenedores o al archivo de imágenes, y la sincronización del reloj.

El servidor recibe el paquete de la versión, un archivo de configuración y las imágenes de contenedor. Nunca recibe código fuente ni se conecta a un repositorio de código.

Instalar​

  1. Copia el paquete del instalador al servidor y descomprímelo:

    tar -xzf excubius-installer-0.4.0.tar.gz
    cd excubius-installer-0.4.0
  2. Si quieres, ejecuta solo las comprobaciones previas. No cambian nada:

    sudo ./install.sh --check-only
  3. Ejecuta el instalador y responde sus preguntas. Presiona Entrar para aceptar el valor entre corchetes:

    sudo ./install.sh

    El instalador guarda tus respuestas, con versiones, para que una actualización solo haga las preguntas nuevas de esa versión.

  4. Cuando termine, abre la dirección pública que muestra e inicia sesión como el administrador que indicaste durante la instalación. Después, configura el inicio de sesión e invita a las personas que usarán Excubius.

Todo lo que hace el instalador queda registrado en /var/log/excubius-install.log, sin secretos.

Las preguntas del instalador​

PreguntaValor predeterminadoNotas
Directorio de instalación/opt/excubiusCualquier ruta absoluta
Cuenta de servicioexcubiusSe crea si no existe. Ejecuta los contenedores sin privilegios de root
URL públicahttps://monitoring.example.comLa dirección que abrirán las personas. Su host es el nombre principal del servidor
AliasNingunoOtros nombres que las personas pueden abrir, separados por espacios, por ejemplo un alias en un dominio que controlas
TLSletsencryptletsencrypt (por HTTP), letsencrypt-dns (por DNS), selfsigned, custom (tus archivos PEM), gateway (TLS termina delante) o later (HTTP sin cifrar por ahora)
Nombres del certificadoallSe pregunta cuando hay alias: deja fuera los nombres que un certificado no puede cubrir
Correo electrónico para Let's Encrypt—Ambos modos de Let's Encrypt
Proveedor de DNS y credenciales—Solo letsencrypt-dns: el id de dnsapi de acme.sh, como dns_cf, dns_dreamhost o dns_azure, y sus variables, que se escriben una por una sin mostrarse en pantalla
Archivos de certificado y clave—Solo custom: la cadena PEM, con el certificado del servidor primero, y una clave sin cifrar
Nombre de usuario y contraseña del administradorUn nombre de usuario sugeridoLa cuenta del primer inicio de sesión, en la dirección que el instalador muestra al terminar. La contraseña necesita 12 caracteres o más y se pide dos veces
Preset baseenterpriseenterprise, databases o core; consulta Configurar la instancia
Usuario y token del registro—Se te entregan con la licencia. No se piden con el paquete sin conexión
Token del bot de Slack y canal— y #alertsOpcional; puedes configurarlos más adelante. Consulta Configurar las notificaciones de Slack
ID de inquilino, ID de cliente y secreto de Entra ID—Opcional; puedes configurarlos más adelante

Con un modo de Let's Encrypt, el instalador comprueba después los nombres en el DNS público y, por HTTP, que apunten a este servidor. Si no apuntan, explica las alternativas; nunca se detiene por eso.

El instalador genera una sola vez la contraseña de la base de datos, el secreto de firma de sesiones, la clave que cifra los secretos guardados y el token del recolector, y nunca los pide. Cuando la plataforma ya guardó la contraseña del administrador, las credenciales de DNS y una clave privada, el instalador las quita del archivo de configuración.

Para instalar sin preguntas, pasa las respuestas en un archivo con --answers; consulta la referencia del instalador.

Nombres y TLS​

ModoÚsalo cuando
Let's Encrypt, validación por HTTPEl nombre se resuelve públicamente al servidor y el puerto 80 es accesible desde internet
Let's Encrypt, validación por DNSEl servidor es privado, pero puedes crear registros DNS mediante una API
Tu propio certificadoTu organización emite certificados
AutofirmadoUn laboratorio o una primera prueba
Puerta de enlaceUn equilibrador de carga o un proxy inverso delante del servidor termina TLS
HTTP sin cifrarUna primera prueba, o una red en la que confías por completo

Puedes cambiar los nombres y el certificado más adelante desde Configuración sin reinstalar, y la renovación es automática. Consulta Configurar nombres y TLS.

Actualizar, reinstalar o desinstalar​

ComandoQué hace
sudo ./install.sh en un servidor ya instaladoOfrece Upgrade (conserva los datos y solo hace las preguntas nuevas), Reinstall, Purge and install fresh o Cancel
sudo ./install.sh --uninstallHace una última copia de seguridad de la base de datos y luego elimina los servicios y las imágenes. Conserva los datos, las copias de seguridad y la configuración
sudo ./install.sh --uninstall --purgeTambién elimina los datos, las copias de seguridad y la cuenta de servicio. Te pide que escribas purge
aviso

Actualiza dentro de una ventana de cambios. Los servicios se reinician durante unos segundos y se ejecutan las migraciones de la base de datos. Antes de empezar, lee los problemas conocidos de la versión.

--dry-run funciona con todos los comandos y solo muestra lo que ocurriría. Los pasos para actualizar, revertir, hacer copias de seguridad y restaurar están en Actualizar, hacer copias de seguridad y restaurar, para usuarios con sesión iniciada.

Vigilar Excubius desde fuera​

Excubius no debe ser lo único que se vigila a sí mismo. Registra https://<your server>/heartbeat en un vigilante externo, como una prueba de disponibilidad de Azure Monitor, Uptime Kuma ejecutándose en otro lugar o un servicio del estilo de healthchecks, y haz que te avise cuando la dirección deje de responder ok. Si el servidor se detiene, ese vigilante es el que te lo dice.

/heartbeat y /healthz responden por HTTP sin cifrar en todos los modos de TLS. /healthz también devuelve la versión que se está ejecutando.

Pasos siguientes​