Guía de instalación
Instrucciones paso a paso para instalar el servidor de Xcellerate RMM usando Docker Compose.
Descripción general
La forma más rápida de desplegar Xcellerate RMM es con Docker Compose. Esta guía te lleva a través de todo el proceso — desde la preparación del host hasta la verificación del servidor en ejecución. Si prefieres una instalación bare-metal, consulta las notas de instalación avanzada al final.
Conceptos clave
- Stack de Docker Compose — el servidor se distribuye como un conjunto de contenedores: interfaz web, API, workers en segundo plano, PostgreSQL y Redis.
- Archivo de entorno (.env) — un archivo único que contiene toda la configuración: credenciales de base de datos, ajustes TLS, relé SMTP y clave de licencia.
- Volúmenes de datos — volúmenes Docker persistentes para la base de datos y los archivos subidos, asegurando que tus datos sobrevivan a los reinicios de contenedores.
Instalación paso a paso
Preparar el host
Instala Docker y Docker Compose en tu servidor. En Ubuntu: sudo apt update && sudo apt install -y docker.io docker-compose-v2. Luego agrega tu usuario al grupo docker: sudo usermod -aG docker $USER y cierra e inicia sesión nuevamente.
Descargar el paquete de Xcellerate
Clona el repositorio de despliegue: git clone https://github.com/rmmlabs/xcellerate-rmm.git && cd xcellerate-rmm. Esto contiene el docker-compose.yml y un archivo de ejemplo .env.example.
Configurar las variables de entorno
Copia el archivo de ejemplo: cp .env.example .env. Abre .env en tu editor y configura como mínimo: SERVER_HOSTNAME, DB_PASSWORD y ADMIN_EMAIL. El archivo está bien comentado — cada variable explica su propósito.
Iniciar el stack
Ejecuta docker compose up -d. Docker descargará las imágenes (~1,2 GB en la primera ejecución), creará los volúmenes e iniciará todos los servicios. El proceso suele tardar entre 2 y 4 minutos.
Verificar la instalación
Abre https://www.n-able.com/wp-content/uploads/2025/10/ns-remote-support-video-thumbnail.png en un navegador. Deberías ver la pantalla de inicio de sesión de Xcellerate RMM. Si usas un certificado autofirmado, tu navegador mostrará una advertencia de seguridad — esto es esperado.
Habilitar TLS con Let's Encrypt
Para producción, habilita TLS automático. Configura TLS_MODE=letsencrypt y [email protected] en tu archivo .env, luego reinicia el stack. El proxy inverso integrado obtendrá y renovará los certificados automáticamente.
# Extracto de .env
SERVER_HOSTNAME=rmm.tuempresa.com
TLS_MODE=letsencrypt
[email protected]Consejos y mejores prácticas
- Siempre usa un nombre de dominio completamente cualificado (FQDN) para
SERVER_HOSTNAME— los agentes dependen de él para conectarse. - Establece un
DB_PASSWORDfuerte y único. Evita caracteres especiales que puedan necesitar escape en contextos de shell. - Haz una copia de seguridad del archivo
.envpor separado — contiene tus credenciales de base de datos y clave de licencia. - Programa actualizaciones automáticas de imágenes Docker con un cron job o Watchtower para mantenerte en las últimas versiones de parches.