Installation

Instalar C21 Live Control

Instalador one-liner del producto C21 Live Control, CLI livecontrol para operación diaria, licencia, backups, SSL y desinstalación.

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.com y Docker Hub
  • Hora sincronizada vía NTP, DNS público resuelto
  • Puertos 9080, 443, 3000, 3100 libres 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:

  1. Verifica que el host cumple los prerrequisitos.
  2. Instala Docker si no está presente.
  3. Descarga el stack compose de Live Control y crea los volúmenes de datos.
  4. Levanta los servicios y ejecuta los health checks.
  5. 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.
  6. 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 operativoUbuntu 22.04 LTS o 24.04 LTS, x86_64
Permisosroot 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 red9080, 443, 3000, 3100 disponibles en el host
Egressget.cires21.com, Docker Hub, hora.cires21.com (o el NTP que prefieras)

Flags del instalador

FlagEfecto
--unattended, -y, --yesModo no interactivo — cada prompt usa su default.
--version <X>Instala una versión específica en lugar de la última.
--check-onlyVerifica requisitos sin instalar.
--upgradeActualiza una instalación existente (equivalente a livecontrol update).
--uninstallElimina la instalación (equivalente a livecontrol uninstall).
--debugLogs 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, -hImprime el listado de flags.

Variables de entorno

VariableEfecto
PRODUCT_VERSIONPinear una versión específica (alternativa a --version).
INSTALL_DIRPath de instalación (default /opt/livecontrol).
UNATTENDED=1Modo no interactivo (equivalente a --unattended).
DEBUG=1Logs verbosos (equivalente a --debug).
LIVECONTROL_PUBLIC_URLIgual 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:

ClavePor defectoQué hace
BACKUP_SCHEDULE"0 3 * * *"Cuándo se hace el backup automático, como expresión cron (con las comillas).
BACKUP_RETENTION_DAYS7Dí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.

Copyright © 2026