tc-operator

tc-operator is het commando dat een Trusted Codes-node op jouw eigen machine installeert en draait. Eén commando op een verse server maakt van de doos een complete, federatie-geschikte thuisserver.

Dit is een Enterprise-mogelijkheid, en dat is het enige waarvoor tc-operator bestaat. Je eigen gefedereerde node draaien maakt deel uit van het Enterprise-abonnement; de tool bestaat om zo’n node te installeren, te configureren en te onderhouden, en doet verder niets. Zit je op een ander abonnement, dan is niets op deze pagina op jou van toepassing — de mobiele app, de desktopclient en de portalen praten allemaal met servers die wij draaien, en er is niets voor jou om te bedienen. Niemand heeft tc-operator nodig om Trusted Codes te gebruiken.

Deze sectie is het pad dat je bewandelt: beslissen of je er een wilt, hem installeren, hem configureren, hem dagelijks draaien, en hem weer afbreken. Wat een gefedereerde server is — de mesh, toelating, wat er tussen servers overgaat — staat in de sectie Gefedereerde server.

Wat je krijgt

De volledige backend op jouw doos: de database, de aanmelddienst, de REST-laag, de edge-functies met alle businesslogica, de API-gateway, bestandsopslag en realtime. Hij draait hetzelfde schema en dezelfde code als de servers die Trusted Codes draait, achter HTTPS op jouw eigen domein.

De node is alleen backend. De clients zijn de mobiele app, de desktop companion en MCP — er is geen webclient om uit te rollen. De node biedt wel een set web-oppervlakken (de beheerapp, en optioneel het gebruikersportaal, het zakelijke portaal, de verify- en statuspagina’s) aan onder jouw domein, en jij kiest welke.

De accounts, verbindingen, codewoorden en kluizen van je leden staan in jouw database en nergens anders.

Wat het je kost

Een machine die je draaiend houdt. De referentiedoos is Ubuntu 26.04 (alles vanaf 22.04 werkt), 2 vCPU, 4 GB RAM, 20 GB schijf. De installer regelt een swapbestand van 4 GB. Het bouwen van oppervlakken vreet geheugen; onder 4 GB worden ze afgebroken.

Een domein en de DNS ervoor. De node heeft een A-record nodig, en elk oppervlak dat je aanzet heeft er zelf ook een nodig.

Een e-mailprovider. Eén SMTP-provider draagt alle post van de node. Een node zonder provider kan niemand aan boord nemen, en start met elk federatieoppervlak gedwongen uit.

Back-ups die je zelf maakt. De installer maakt maar in één geval een databasedump: bij het verwijderen. Een draaiende node heeft je eigen schema nodig — en de dump alleen is niet genoeg om te herstellen. Zie Back-ups en herstel.

Actueel blijven. Een node is geen private fork. Updates komen als nieuwe distributiearchieven en jij past ze toe.

Wat niet van jou is om te draaien

Facturatie en de inloggegevens voor mobiele push blijven centraal. Net als het rechtenplafond waaronder jouw node draait: dat wordt centraal toegekend en ondertekend, en de beheerrol van jouw node kan het niet verhogen. De federatiesectie legt uit waarom.

De onderdelen die eenrichtingsverkeer zijn

Lees deze voordat je begint, niet erna.

uninstall --purge vernietigt de node en zijn data. Hij maakt eerst een dump en weigert zonder --purge wanneer er echte gebruikers zijn, maar voorbij die bevestiging is er geen weg terug.
rollback herstelt alleen code. Het databaseschema gaat alleen voorwaarts en wordt niet teruggedraaid. Oude code draait dan tegen het huidige schema.
/etc/trusted-codes/secrets.env kwijtraken kost je de node. Teruggezette data is onleesbaar zonder de oorspronkelijke versleutelingssleutel, en de node krijgt een nieuwe federatie-identiteit. Maak er een back-up van bij elke dump.
home_server kan niet worden gewijzigd op een draaiende node. Hem wijzigen is een nieuwe identiteit: nieuwe DNS, nieuwe TLS, nieuwe toelating.

Waar je verder kunt lezen

Voordat je begint — wat alleen jij kunt leveren.
Een node installeren — de vier stappen en de twee handmatige.
operator.yaml — het ene bestand dat je bewerkt, en een wijziging toepassen op een draaiende node.
De node draaien — status, oppervlakken, beheeraccounts.
Bijwerken, back-ups en terugrollen — en wat terugrollen niet doet.
Een node verwijderen — het destructieve pad, ronduit gesteld.