docs: add configuration section#6
Merged
Merged
Conversation
Add a Configuration section with a custom fonts page covering bare-metal and Docker, linked from the nav and start page. Assisted-by: ClaudeCode:claude-opus-4-8 Signed-off-by: Julius Knorr <jus@bitgrid.net>
Document the local.json model (deb/rpm) and the Docker environment variables, with the verified config key paths each one maps to. Link the Docker install page to the full reference. Assisted-by: ClaudeCode:claude-opus-4-8 Signed-off-by: Julius Knorr <jus@bitgrid.net>
The standalone Docker image only accepts DB_TYPE=postgres; other engines require the cluster image. Verified against the entrypoint in DocumentServer. Assisted-by: ClaudeCode:claude-opus-4-8 Signed-off-by: Julius Knorr <jus@bitgrid.net>
Document installing editor plugins into sdkjs-plugins via documentserver-pluginsmanager.sh for package and Docker installs, and cross-link the integration plugin list. Verified against DocumentServer. Assisted-by: ClaudeCode:claude-opus-4-8 Signed-off-by: Julius Knorr <jus@bitgrid.net>
Document the documentserver-* admin scripts (configure, jwt-status, flush-cache, securelink, static-gzip, prepare4shutdown, letsencrypt) for package and Docker installs. Verified against DocumentServer. Assisted-by: ClaudeCode:claude-opus-4-8 Signed-off-by: Julius Knorr <jus@bitgrid.net>
Document log4js log levels via production.json and the DS_LOG_LEVEL Docker variable, plus per-service log file locations. Verified against DocumentServer. Assisted-by: ClaudeCode:claude-opus-4-8 Signed-off-by: Julius Knorr <jus@bitgrid.net>
Replace the start page cards with one per top-level section (Introduction, Installation, Configuration, Integration, Development) and drop the now-redundant list. Assisted-by: ClaudeCode:claude-opus-4-8 Signed-off-by: Julius Knorr <jus@bitgrid.net>
Cover finding plugins from the upstream sdkjs-plugins collection, mounting plugins in Docker, the in-editor plugin manager, and plugin removal. Signed-off-by: Julius Knorr <jus@bitgrid.net> Assisted-by: ClaudeCode:claude-opus-4-8
Signed-off-by: Julius Knorr <jus@bitgrid.net> Assisted-by: ClaudeCode:claude-opus-4-8 Signed-off-by: Julius Knorr <jus@bitgrid.net>
Signed-off-by: Julius Knorr <jus@bitgrid.net> Assisted-by: ClaudeCode:claude-opus-4-8 Signed-off-by: Julius Knorr <jus@bitgrid.net>
…lanation Replace placeholder `your-secret` and `dev-secret` with a working example (`at-least-32-chars-long-for-hs256`) across all configuration and Docker examples. The placeholder `your-secret` (12 chars) would fail the HS256 32-char minimum enforced by the document server's JWT implementation. - Add explanation of the 32-char minimum requirement in server.md - Add `openssl rand -hex 32` command for generating valid secrets - Add 32-char warning to server.md and Nextcloud integration guide - Update all `your-secret` and `dev-secret` examples in Docker commands Assisted-by: OpenCode:qwen3.6-27b Signed-off-by: Christoph Schaefer <christoph.schaefer@nextcloud.com>
chrip
approved these changes
Jun 25, 2026
chrip
left a comment
chrip
left a comment
Contributor
There was a problem hiding this comment.
Replaced your-secret and dev-secret with a valid 32-char example across all docs.
One note: Paths like log directories differ on branded builds (e.g., /var/log/nextcloud-office/ vs /var/log/euro-office/). We should probably add a brief note in the logging or configuration guide. And we have to remember that, if we merge parts of this doc into the nextcloud docs.
Member
Author
|
Thanks, will push a commit to adapt this to be brandable. I had some logic in place here already. |
Branded builds use a different on-disk namespace (e.g. nextcloud-office),
so replace the hardcoded euro-office token in install/config/log paths,
the package name, and example container names with a new
{{ brand.package_path_name }} macro.
Signed-off-by: Julius Knorr <jus@bitgrid.net>
Assisted-by: ClaudeCode:claude-opus-4-8
github-project-automation
Bot
moved this from 👀 In review
to ☑️ Done
in 📄 Euro-Office team
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds a Configuration section to the docs:
Values verified against the
serverandDocumentServerrepositories. Linked from the start page, Docker install page, and the integration plugin list.