BIG Messages in Startup: Configuration validation failed / Failed to start Federation-Matrix-Service

[thokich]

Description:

After i have update Rocket from 7.10.2 to 7.11.0 in the docker Enviroment, i have the startup error Message in the ContainerLog

{"level":50,"time":1760899587978,"pid":1,"hostname":"012202d891df","name":"homeserver","name":"ConfigService","msg":"Configuration validation failed:","err":{"type":"ZodError","message":"[\n {\n "code": "too_small",\n "minimum": 1,\n "type": "string",\n "inclusive": true,\n "exact": false,\n "message": "Server name is required",\n "path": [\n "serverName"\n ]\n },\n {\n "code": "too_small",\n "minimum": 1,\n "type": "string",\n "inclusive": true,\n "exact": false,\n "message": "Matrix domain is required",\n "path": [\n "matrixDomain"\n ]\n }\n]","stack":"[\n {\n "code": "too_small",\n "minimum": 1,\n "type": "string",\n "inclusive": true,\n "exact": false,\n "message": "Server name is required",\n "path": [\n "serverName"\n ]\n },\n {\n "code": "too_small",\n "minimum": 1,\n "type": "string",\n "inclusive": true,\n "exact": false,\n "message": "Matrix domain is required",\n "path": [\n "matrixDomain"\n ]\n }\n]\n at Object.get error [as error] (/app/bundle/programs/server/npm/node_modules/zod/lib/types.js:55:31)\n at ZodObject.parse (/app/bundle/programs/server/npm/node_modules/zod/lib/types.js:131:22)\n at new V (/app/bundle/programs/server/npm/node_modules/@rocket.chat/federation-matrix/node_modules/@rocket.chat/packages/federation-sdk/src/services/config.service.ts:89:34)\n at setupFederationMatrix (/app/bundle/programs/server/npm/node_modules/@rocket.chat/federation-matrix/src/setup.ts:55:17)\n at processTicksAndRejections (node:internal/process/task_queues:105:5)\n at startFederationService (ee/server/startup/federation.ts:13:21)\n at loadAfterLicense (startRocketChat.ts:10:2)\n at startRocketChat (startRocketChat.ts:18:2)\n at module.wrapAsync.self (server/main.ts:29:1)","aggregateErrors":[{"type":"Object","message":"Server name is required","stack":"","code":"too_small","minimum":1,"inclusive":true,"exact":false,"path":["serverName"]},{"type":"Object","message":"Matrix domain is required","stack":"","code":"too_small","minimum":1,"inclusive":true,"exact":false,"path":["matrixDomain"]}],"issues":[{"code":"too_small","minimum":1,"type":"string","inclusive":true,"exact":false,"message":"Server name is required","path":["serverName"]},{"code":"too_small","minimum":1,"type":"string","inclusive":true,"exact":false,"message":"Matrix domain is required","path":["matrixDomain"]}],"name":"ZodError"}}
{"level":50,"time":"2025-10-19T18:46:28.035Z","pid":1,"hostname":"012202d891df","name":"Federation","msg":"Failed to start federation-matrix service: {}"}

Steps to reproduce:

1. Startup the Container with Version 7.11.0

Expected behavior:

Deactivation the Federation startup, i do not need it.
I have in the Setup
Federation allows remote workspaces to communicate with each other through the Matrix protocol.
Enable native federation --> deaktivate
Enable native federation for inter-server communication using Matrix Protocol.

Why I must configure this parameters when the function ist deactivated ?
i have set in docker-compose the env Variable

• Federation_Service_Enabled=false
  and the ERROR Message is present.

{"level":50,"time":1760902912256,"pid":1,"hostname":"3d8fe70d21e4","name":"homeserver","name":"ConfigService","msg":"Configuration validation failed:","err":{"type":"ZodError","message":"[\n {\n "code": "too_small",\n "minimum": 1,\n "type": "string",\n "inclusive": true,\n "exact": false,\n "message": "Server name is required",\n "path": [\n "serverName"\n ]\n },\n {\n "code": "too_small",\n "minimum": 1,\n "type": "string",\n "inclusive": true,\n "exact": false,\n "message": "Matrix domain is required",\n "path": [\n "matrixDomain"\n ]\n }\n]","stack":"[\n {\n "code": "too_small",\n "minimum": 1,\n "type": "string",\n "inclusive": true,\n "exact": false,\n "message": "Server name is required",\n "path": [\n "serverName"\n ]\n },\n {\n "code": "too_small",\n "minimum": 1,\n "type": "string",\n "inclusive": true,\n "exact": false,\n "message": "Matrix domain is required",\n "path": [\n "matrixDomain"\n ]\n }\n]\n at Object.get error [as error] (/app/bundle/programs/server/npm/node_modules/zod/lib/types.js:55:31)\n at ZodObject.parse (/app/bundle/programs/server/npm/node_modules/zod/lib/types.js:131:22)\n at new V (/app/bundle/programs/server/npm/node_modules/@rocket.chat/federation-matrix/node_modules/@rocket.chat/packages/federation-sdk/src/services/config.service.ts:89:34)\n at setupFederationMatrix (/app/bundle/programs/server/npm/node_modules/@rocket.chat/federation-matrix/src/setup.ts:55:17)\n at processTicksAndRejections (node:internal/process/task_queues:105:5)\n at startFederationService (ee/server/startup/federation.ts:13:21)\n at loadAfterLicense (startRocketChat.ts:10:2)\n at startRocketChat (startRocketChat.ts:18:2)\n at module.wrapAsync.self (server/main.ts:29:1)","aggregateErrors":[{"type":"Object","message":"Server name is required","stack":"","code":"too_small","minimum":1,"inclusive":true,"exact":false,"path":["serverName"]},{"type":"Object","message":"Matrix domain is required","stack":"","code":"too_small","minimum":1,"inclusive":true,"exact":false,"path":["matrixDomain"]}],"issues":[{"code":"too_small","minimum":1,"type":"string","inclusive":true,"exact":false,"message":"Server name is required","path":["serverName"]},{"code":"too_small","minimum":1,"type":"string","inclusive":true,"exact":false,"message":"Matrix domain is required","path":["matrixDomain"]}],"name":"ZodError"}}
{"level":50,"time":"2025-10-19T19:41:52.307Z","pid":1,"hostname":"3d8fe70d21e4","name":"Federation","msg":"Failed to start federation-matrix service: {}"}

Actual behavior:

Server Setup Information:

+---------------------------------------------------------+
| SERVER RUNNING |
+---------------------------------------------------------+
| |
| Rocket.Chat Version: 7.11.0 |
| NodeJS Version: 22.16.0 - x64 |
| MongoDB Version: 7.0.7 |
| MongoDB Engine: wiredTiger |
| Platform: linux |
| Process Port: 3000 |
| Site URL: https://rocketchat.deutschland.de |
| ReplicaSet OpLog: Enabled |
| Commit Hash: 8d69961 |
| Commit Branch: HEAD |
| |
+---------------------------------------------------------+

[reetp]

Asking team for comments.

(NB. It is always advisable to run a test server and test upgrades before trying it in production)

[thokich]

Hello reetp, things have been quiet between us for a long time because Rocket was running very well. My words: no production without testing. I've been doing this job for thirty years and preach similar words to you. Furthermore, the experienced admin always made a backup (offline) before updating. The bug affects not the basic functionality of the server; only is the federation of the Matrix part affected. I'm curious to see if there will be a fix or a workaround. Thanks for your support.
I belive the variable Matrix domain is required = Federation-Domain in RC: deutschland.de :-) i must set in the Database via the GUI.

[reetp]

Were you using any form of Federation before?

Is this just your test server?

I've referred it to the team. We'll see what happens.

[thokich]

No i have not using and configurated any form of Federation before.
Rocket is only local using without connect to other server bevor.

[reetp]

FYI devs are aware about this.

[thokich]

I have Update the Server and the startup ERROR message is not fixed.
+---------------------------------------------------------+
| SERVER RUNNING |
+---------------------------------------------------------+
| |
| Rocket.Chat Version: 7.12.0 |
| NodeJS Version: 22.16.0 - x64 |
| MongoDB Version: 7.0.7 |
| MongoDB Engine: wiredTiger |
| Platform: linux |
| Process Port: 3000 |
| Site URL: https://rocketchat.deutschland.de |
| ReplicaSet OpLog: Enabled |
| Commit Hash: 05f9767 |
| Commit Branch: HEAD |
| |
+---------------------------------------------------------+