Uh oh!
There was an error while loading. Please reload this page.
docs(config): update Snowflake serverid config.sample explanation - #58577
docs(config): update Snowflake serverid config.sample explanation#58577joshtrichards wants to merge 1 commit into
serverid config.sample explanation#58577Conversation
- Add additional detail/context Signed-off-by: Josh <josh.t.richards@gmail.com>
joshtrichards
commented
Feb 25, 2026
/backport to stable33 |
Context: This will be the default behavior and visible message to any instance upgraded from <v33. Builds on #58577 Signed-off-by: Josh <josh.t.richards@gmail.com>
Altahrim
left a comment
There was a problem hiding this comment.
Thank you for the improvements :)
I think there is still a few points to clarify but it's better than my original one ^^
| * It is useful when your Nextcloud instance is using different PHP servers. | ||
| * Once it's set it shouldn't be changed. | ||
| * This parameter is used to differentiate between different PHP server instances | ||
| * that share the same ``config.php``. Its core use is in the "Snowflake" ID generation |
There was a problem hiding this comment.
that share the same
config.php
The important point is they share the same database. For some reasons, it can be different configuration files
| * When config.php is shared between different servers, this value should be overriden with "NC_serverid=<int>" on each server. | ||
| * Note that it must be overriden for CLI and for your webserver. | ||
| * This parameter is especially important if you deploy Nextcloud across multiple servers | ||
| * using a shared ``config.php`` file. |
There was a problem hiding this comment.
| * using a shared ``config.php`` file. |
For the same reason as above
| * using a shared ``config.php`` file. | ||
| * | ||
| * Example for CLI: NC_serverid=42 occ config:list system | ||
| * Once it is set, it should not be changed, to avoid data inconsistencies. |
There was a problem hiding this comment.
Actually it can be changed, but the important point to never have two identical server IDs in your cluster.
One drawback of changing it: you can't find the server which created an ID from the ID itself (unless you keep history). I don't know if it will help for debugging at some point…
| * Example for CLI: NC_serverid=42 occ config:list system | ||
| * Once it is set, it should not be changed, to avoid data inconsistencies. | ||
| * | ||
| * In shared configurations, override ``serverid`` by setting the environment variable |
There was a problem hiding this comment.
It can also be a different config.php file
| * NC_serverid=42 occ config:list system | ||
| * | ||
| * For simple, standalone deployments, the default fallback (based on the hostname) | ||
| * is generally safe as long as your server's hostname does not change and you do not |
There was a problem hiding this comment.
as long as your server's hostname does not change
See above, if hostname change, server ID also change and it's not an issue, except to find server responsible for the ID
melroy89
commented
Feb 26, 2026
Could this be documented as well plz? https://docs.nextcloud.com/server/32/admin_manual/configuration_server/config_sample_php_parameters.html |
Summary
Adds additional detail/context and clarity regarding this newer parameter.
TODO
Checklist
3. to review, feature component)stable32)AI (if applicable)