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>:9443/.

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, 9443, 3000, 3100 libres en el host

Pasos

curl -fsSL https://get.cires21.com/livecontrol | sudo bash

sudo livecontrol license info

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)

[C21LiveControl]
Expiration=31-12-3000
Quantity=1
Key=<key-1>
[C21LiveDeploy]
Expiration=31-12-3000
Quantity=1
Key=<key-2>
...

sudo livecontrol license install /ruta/a/license.txt
sudo livecontrol restart

sudo livecontrol license verify

Plataforma soportada

Flags del instalador

Variables de entorno

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             # Imprime versión instalada
sudo livecontrol config              # Configuración actual (default: show)
sudo livecontrol config edit         # Editar configuración (`$EDITOR` o nano)
sudo livecontrol activate            # Activa el grupo docker para la sesión actual

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

El instalador programa un backup automático diario a las 03:00 con retención de 7 días. Los backups incluyen la configuración y un dump de la base de datos; se almacenan cifrados en /var/backups/livecontrol/.

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 <mysql|admin|reset [<user>]>   # Rota la password indicada

security password reset <user> devuelve la cuenta al estado inicial y obliga a cambio en el siguiente login.

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.
• Instalar C21 Live Encoder — empareja un encoder con esta instancia de Control.
• 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.