tc-operator

tc-operator es el comando que instala y ejecuta un nodo de Trusted Codes en tu propia máquina. Un comando en un servidor nuevo convierte la máquina en un servidor de origen completo, capaz de federarse.

Esto es una capacidad de Enterprise, y es lo único para lo que sirve tc-operator. Llevar tu propio nodo federado forma parte del plan Enterprise; la herramienta existe para instalar, configurar y mantener un nodo así y no hace nada más. Si estás en cualquier otro plan, nada de esta página se aplica a ti — la aplicación móvil, el cliente de escritorio y los portales hablan todos con servidores que llevamos nosotros, y no hay nada que tengas que operar. Nadie necesita tc-operator para usar Trusted Codes.

Esta sección es el camino que recorres: decidir si quieres uno, instalarlo, configurarlo, llevarlo el día a día, y volver a retirarlo. Lo que es un servidor federado — la malla, la admisión, qué cruza entre servidores — está cubierto en la sección Servidor federado.

Qué obtienes

El backend completo en tu máquina: la base de datos, el servicio de inicio de sesión, la capa REST, las funciones de borde que llevan toda la lógica de negocio, la puerta de enlace de la API, el almacenamiento de archivos y el tiempo real. Ejecuta el mismo esquema y el mismo código que los servidores que lleva Trusted Codes, detrás de HTTPS en tu propio dominio.

El nodo es solo backend. Los clientes son la aplicación móvil, el compañero de escritorio y MCP — no hay ningún cliente web que desplegar. El nodo sí sirve un conjunto de superficies web (la aplicación de administración, y opcionalmente el portal de usuario, el portal de negocio, verificación y las páginas de estado) bajo tu dominio, y tú eliges cuáles.

Las cuentas, conexiones, códigos y bóvedas de tus miembros viven en tu base de datos y en ningún otro sitio.

Qué te cuesta

Una máquina que mantienes en marcha. La máquina de referencia es Ubuntu 26.04 (cualquier cosa desde 22.04 funciona), 2 vCPU, 4 GB de RAM, 20 GB de disco. El instalador aprovisiona un archivo de intercambio de 4 GB. Las construcciones de superficies consumen mucha memoria; por debajo de 4 GB las matan.

Un dominio y su DNS. El nodo necesita un registro A, y cada superficie que actives necesita el suyo propio.

Un proveedor de correo. Un proveedor SMTP lleva todo el correo del nodo. Un nodo sin uno no puede dar de alta a nadie, y arranca con cada superficie de federación forzada a desactivada.

Copias de seguridad que haces tú mismo. El instalador solo hace un volcado de la base de datos cuando desinstalas. Un nodo en marcha necesita tu propio calendario — y el volcado solo no basta para recuperar. Consulta Copias de seguridad y recuperación.

Mantenerte al día. Un nodo no es una bifurcación privada. Las actualizaciones llegan como nuevos archivos de distribución y tú los aplicas.

Lo que no es tuyo para llevar

La facturación y las credenciales de notificaciones push móviles se quedan centrales. También el techo de derechos bajo el que funciona tu nodo: se concede y se firma de forma centralizada, y el rol de administrador de tu nodo no lo puede subir. La sección de federación explica por qué.

Las partes que son de un solo sentido

Lee esto antes de empezar, no después.

• uninstall --purge destruye el nodo y sus datos. Hace un volcado primero y se niega sin --purge cuando hay usuarios reales, pero pasada esa confirmación no hay vuelta atrás.
• rollback revierte solo el código. El esquema de la base de datos solo avanza y no se revierte. El código antiguo se ejecuta entonces contra el esquema actual.
• Perder /etc/trusted-codes/secrets.env pierde el nodo. Los datos restaurados quedan ilegibles sin la clave de cifrado original, y el nodo obtiene una nueva identidad de federación. Haz una copia de seguridad de él con cada volcado.
• home_server no se puede cambiar en un nodo en marcha. Cambiarlo es una identidad nueva: nuevo DNS, nuevo TLS, nueva admisión.

Adónde ir después

• Antes de empezar — lo que solo tú puedes aportar.
• Instalar un nodo — los cuatro pasos y los dos manuales.
• operator.yaml — el único archivo que editas, y cómo aplicar un cambio a un nodo en marcha.
• Ejecutar el nodo — estado, superficies, cuentas de administrador.
• Actualizar, copias de seguridad y rollback — y lo que rollback no hace.
• Retirar un nodo — el camino destructivo, dicho sin rodeos.