Skip to content

Commit bfb4985

Browse files
committed
fix(migration): correct serverid description
serverid is not generated at install time — it is a static integer (default -1) that identifies a server in multi-PHP-server setups. Separate it from secret/instanceid and accurately describe when it matters and what to do with NC_serverid env overrides. Signed-off-by: skjnldsv <skjnldsv@protonmail.com>
1 parent 4849d81 commit bfb4985

1 file changed

Lines changed: 8 additions & 4 deletions

File tree

admin_manual/maintenance/migrating.rst

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -107,10 +107,14 @@ the new location. It is also assumed that the authentication method
107107
* ``tempdirectory`` — if set to a custom path, make sure that path exists and
108108
is writable on the new server.
109109

110-
The ``secret``, ``instanceid``, and ``serverid`` values are generated once at
111-
install time and tied to all encrypted data, user sessions, and federation
112-
identity. **Do not change or regenerate them.** They must be copied verbatim
113-
from the original ``config.php``.
110+
The ``secret`` and ``instanceid`` values are generated once at install time and
111+
tied to all encrypted data and user sessions. **Do not change or regenerate them.**
112+
They must be copied verbatim from the original ``config.php``.
113+
114+
If ``serverid`` is set, keep the same value. It identifies the server in
115+
multi-PHP-server setups and must not change. If you override it per server via
116+
the ``NC_serverid`` environment variable, configure the same override on the new
117+
server.
114118

115119
Leaving stale values (especially database credentials or ``datadirectory``)
116120
will cause startup errors or data corruption.

0 commit comments

Comments
 (0)