Instalar C21 Live Control
Qué se instala
El producto C21 Live Control, empaquetado como un stack Docker compose. El instalador levanta la UI operador, la API REST, la capa de WebSocket, el servidor MCP y la base de datos integrada; el resultado es una instancia accesible en https://<host>/.
El host puede emparejarse después con una o varias instancias de C21 Live Encoder (consulta Instalar C21 Live Encoder) y con un fichero de licencia (consulta el paso 3 abajo).
Antes de empezar
Verifica que el host cumple los prerrequisitos descritos en Preparar el host. Mínimo:
- Ubuntu 22.04 LTS o 24.04 LTS, x86_64
- 2 cores / 4 GiB RAM / 20 GiB libres en
/(4 cores / 8 GiB RAM recomendados) - Salida HTTPS hacia
get.cires21.comy Docker Hub - Hora sincronizada vía NTP, DNS público resuelto
- Puertos
9080,443,3000,3100libres en el host
Para ejecutar Live Control y Live Encoder en el mismo host, sigue en su lugar Instalar C21 Live Control y C21 Live Encoder en un único host: los dos productos usan el puerto 443.
Pasos
1. Ejecuta el instalador one-liner
curl -fsSL https://get.cires21.com/livecontrol | sudo bash
El instalador en orden:
- Verifica que el host cumple los prerrequisitos.
- Instala Docker si no está presente.
- Descarga el stack compose de Live Control y crea los volúmenes de datos.
- Levanta los servicios y ejecuta los health checks.
- Imprime la URL de acceso, la URL del servidor MCP con el puerto realmente publicado y el fingerprint del host necesario para solicitar la licencia. No imprime ningún secreto: dice dónde se guardan las credenciales iniciales y la API key del servidor MCP y qué comando las muestra (
sudo livecontrol security password admin,sudo livecontrol mcp-key). De la key MCP solo muestra los 4 últimos caracteres, para distinguirla de otra. - Informa del estado de actualizaciones del sistema operativo del host — si las actualizaciones automáticas están activas, cuántas actualizaciones de seguridad están pendientes y si hay un reinicio pendiente — sin modificar nada; la decisión es del operador.
2. Obtén el fingerprint del host
Para solicitar la licencia, necesitas el fingerprint que identifica tu host. Obténlo con:
sudo livecontrol license info
La salida incluye una sección como:
C21 Live Control — License binding info
========================================
Host fingerprint: 73250bef2e5af1b5deb8e5e4d7506dff
License file: /opt/livecontrol/data/license.txt
Current license: (not installed)
Required product slots: C21LiveControl, C21LiveDeploy, C21LiveEditor (opcional), C21LiveDRM (opcional)
Envía el valor de Host fingerprint a tu representante de Cires21 junto con los slots de producto que tu contrato cubre.
3. Instala la licencia
Cires21 te enviará un fichero license.txt con secciones INI por cada producto contratado:
[C21LiveControl]
Expiration=31-12-3000
Quantity=1
Key=<key-1>
[C21LiveDeploy]
Expiration=31-12-3000
Quantity=1
Key=<key-2>
...
Súbelo desde la UI: abre https://<host>/, autentícate como admin con la password inicial (la muestra sudo livecontrol security password admin) y al hacer login se te presentará el formulario de licencia. Selecciona el fichero license.txt y confírmalo.
Alternativamente desde CLI:
sudo livecontrol license install /ruta/a/license.txt
sudo livecontrol restart
Tras la instalación, verifica:
sudo livecontrol license verify
Debe imprimir cada slot con status: true y la fecha de expiración (Unlimited cuando el valor centinela 31-12-3000 aplica).
4. Primer login y rotación de credenciales
Abre la UI y autentícate con las credenciales iniciales, que muestra sudo livecontrol security password admin. La UI te pedirá que rotes la password del admin antes de cualquier otra operación — es parte del primer-uso obligatorio.
Las credenciales iniciales también quedan en /opt/livecontrol/.credentials (modo 0600, propietario root) en el host.
Plataforma soportada
| Sistema operativo | Ubuntu 22.04 LTS o 24.04 LTS, x86_64 |
| Permisos | root o sudo |
| CPU (mínimo / recomendado) | 2 cores / 4+ cores |
| RAM (mínimo / recomendado) | 4 GiB / 8+ GiB |
| Disco (mínimo / recomendado) | 20 GiB / 50+ GiB |
| Puertos de red | 9080, 443, 3000, 3100 disponibles en el host |
| Egress | get.cires21.com, Docker Hub, hora.cires21.com (o el NTP que prefieras) |
Flags del instalador
| Flag | Efecto |
|---|---|
--unattended, -y, --yes | Modo no interactivo — cada prompt usa su default. |
--version <X> | Instala una versión específica en lugar de la última. |
--check-only | Verifica requisitos sin instalar. |
--upgrade | Actualiza una instalación existente (equivalente a livecontrol update). |
--uninstall | Elimina la instalación (equivalente a livecontrol uninstall). |
--debug | Logs verbosos del instalador. No llevan secretos. |
--public-url <url> | Dirección con la que los usuarios abren Live Control (p. ej. https://lc.example.com). Los enlaces de descarga que entrega el servidor MCP se construyen sobre ella. Si no se indica, se pregunta en una instalación interactiva; se guarda como LIVECONTROL_PUBLIC_URL en .env y se conserva al actualizar. |
--help, -h | Imprime el listado de flags. |
Variables de entorno
| Variable | Efecto |
|---|---|
PRODUCT_VERSION | Pinear una versión específica (alternativa a --version). |
INSTALL_DIR | Path de instalación (default /opt/livecontrol). |
UNATTENDED=1 | Modo no interactivo (equivalente a --unattended). |
DEBUG=1 | Logs verbosos (equivalente a --debug). |
LIVECONTROL_PUBLIC_URL | Igual que --public-url. |
El servidor MCP se publica en el puerto 3100. Para publicarlo en otro puerto del host, fija MCP_HOST_PORT en el .env de la instalación una vez instalada; las actualizaciones lo conservan, y el resumen final del instalador muestra el puerto realmente publicado.
Ejemplo no-interactivo
curl -fsSL https://get.cires21.com/livecontrol | sudo bash -s -- --unattended --version 6.10.1
Operación diaria
Tras instalar, el CLI livecontrol queda disponible en el host. Ejecútalo siempre con sudo — los paths de configuración y datos viven bajo /opt/livecontrol con permisos restringidos.
Control de servicios
sudo livecontrol status # Estado con health checks
sudo livecontrol start
sudo livecontrol stop
sudo livecontrol restart [service]
sudo livecontrol logs [service] # Tail; `-f` para seguir, `-n N` para N líneas
sudo livecontrol version # Versión instalada, y la versión y el commit de cada contenedor en marcha
sudo livecontrol config # Configuración actual, con los secretos enmascarados (default: show)
sudo livecontrol config edit # Editar configuración (`$EDITOR` o nano)
sudo livecontrol activate # Activa el grupo docker para la sesión actual
sudo livecontrol mcp-key # Imprime la API key del servidor MCP, y nada más
Licencia
sudo livecontrol license info # Host fingerprint + estado actual
sudo livecontrol license install <fichero>
sudo livecontrol license verify # Estado de cada slot del fichero instalado
Consulta Licencias para el catálogo completo de productos y los gates por licencia.
Backups
sudo livecontrol backup [name] # Backup manual (auto-nombrado si se omite name)
sudo livecontrol restore # Lista los backups disponibles
sudo livecontrol restore <fichero> # Restaura desde un backup específico
sudo livecontrol backup-schedule # Muestra la programación y la retención del backup automático
sudo livecontrol backup-schedule apply # Aplica ya una programación cambiada en .env
Los backups incluyen la configuración y un dump de la base de datos; se almacenan cifrados con AES-256 en /var/backups/livecontrol/. Es la única copia de la base de datos: la web no la descarga.
Antes de sustituir nada, restore hace un backup del estado actual, base de datos incluida, para poder volver atrás. Si la base de datos actual no se puede respaldar, restore se detiene sin cambiar nada; si MySQL ya está caído, sudo livecontrol restore <fichero> --without-db-backup continúa con una copia solo de la configuración.
El instalador programa un backup automático diario a las 03:00 y conserva 7 días. Las dos cosas se configuran en el .env de la instalación y se mantienen en cada actualización:
| Clave | Por defecto | Qué hace |
|---|---|---|
BACKUP_SCHEDULE | "0 3 * * *" | Cuándo se hace el backup automático, como expresión cron (con las comillas). |
BACKUP_RETENTION_DAYS | 7 | Días que se conserva un backup automático; se aplica desde la siguiente ejecución del backup. La misma limpieza borra un backup manual sin nombre (livecontrol backup sin nombre) cuando alcanza esa edad. El mantenimiento semanal borra los backups sin cifrar más antiguos que eso (nunca por debajo de 7 días); los backups manuales y previos a una actualización cifrados se conservan hasta sudo livecontrol cleanup. |
Un cambio de programación necesita sudo livecontrol backup-schedule apply (el instalador también lo aplica en la siguiente actualización); un cambio de retención se aplica solo en la siguiente ejecución del backup.
Actualizaciones
El flujo se detalla en Actualizaciones. Referencia rápida:
sudo livecontrol update --check
sudo livecontrol update <version>
sudo livecontrol update <version> --no-backup # Sin backup previo (no recomendado)
sudo livecontrol update <version> --force # Reinstala la misma versión y salta prompts
La actualización ejecuta un backup previo, descarga las imágenes nuevas, reinicia el stack y hace rollback automático si algún paso falla.
SSL
sudo livecontrol ssl status
sudo livecontrol ssl info
sudo livecontrol ssl generate [días] # Genera certificado self-signed
sudo livecontrol ssl import <cert.crt> <key.pem> # Importa par CA-firmado
El instalador genera un certificado self-signed por defecto. livecontrol ssl import valida que el certificado y la clave correspondan antes de instalarlos.
Seguridad
sudo livecontrol security status
sudo livecontrol security audit
sudo livecontrol security harden # Hardening por defecto
sudo livecontrol security password admin # Muestra las credenciales iniciales de admin, oper y cires21 (no cambia nada)
sudo livecontrol security password mysql # Pasos para rotar la password root de MySQL
sudo livecontrol security password reset [<user>] # Restablece la password y desbloquea la cuenta (por defecto: admin)
security password reset <user> devuelve la cuenta al estado inicial y obliga a cambio en el siguiente login.
Estos comandos endurecen la propia instalación. Lo que el host debe garantizar alrededor (cifrado de disco, acceso restringido, una base de datos que no sale del host, copias de backups cifradas) está en Requisitos de seguridad del despliegue.
Mantenimiento
sudo livecontrol cleanup [--dry-run]
El instalador también programa mantenimiento automático semanal (rotación de logs, eliminación de recursos Docker huérfanos, purga de backups fuera de retención).
Desinstalar
sudo livecontrol uninstall # Interactivo — pide escribir 'UNINSTALL'
sudo livecontrol uninstall --keep-backups
sudo livecontrol uninstall --keep-data
sudo livecontrol uninstall --force # Sin prompt
La desinstalación detiene y elimina los contenedores, elimina el set de imágenes, elimina los volúmenes de datos (a menos que se use --keep-data), elimina la unidad systemd, los crons y el propio CLI.
Cross-links
- Preparar el host — DNS, NTP, ufw, swap antes del install.
- Requisitos de seguridad del despliegue — lo que el host debe garantizar alrededor de la instalación.
- Instalar C21 Live Encoder — empareja un encoder con esta instancia de Control.
- Control y Encoder en un único host — despliegue en host compartido, puerto 9443 y firewall.
- Actualizaciones — flujo de actualización para Control y Encoder.
- Licencias — catálogo de licencias, gates por feature, formato de fichero.
- Devices — añade un Encoder registrado a esta instancia tras el onboarding.
Preparar el host
Lleva un host Linux al estado conocido que esperan los instaladores de C21 Live Control y C21 Live Encoder.
Instalar C21 Live Encoder
Instalador one-liner del producto C21 Live Encoder, matriz de drivers de hardware, CLI liveencoder y el flujo de onboarding a una instancia de C21 Live Control.