[GH-ISSUE #388] Documentation-extension on configuration for variables #198

Closed
opened 2026-02-26 10:30:54 +03:00 by kerem · 5 comments
Owner

Originally created by @aignerat on GitHub (Oct 14, 2021).
Original GitHub issue: https://github.com/ONLYOFFICE/Docker-DocumentServer/issues/388

Do you want to request a feature or report a bug?
feature

What is the current behavior?
Documentserver Configuration is hardcoded - Especially on the publically known storage-Secret-Key "verysecretkey"

What is the expected behavior?
Documentation on how to change Config-Values in the recommended way (most probably ENV).

DocumentServer Docker tag:
Documentation

Host Operating System:
Centos 7 (irrelevant)

Originally created by @aignerat on GitHub (Oct 14, 2021). Original GitHub issue: https://github.com/ONLYOFFICE/Docker-DocumentServer/issues/388 **Do you want to request a *feature* or report a *bug*?** feature **What is the current behavior?** Documentserver Configuration is hardcoded - Especially on the publically known storage-Secret-Key "verysecretkey" **What is the expected behavior?** Documentation on how to change Config-Values in the recommended way (most probably ENV). **DocumentServer Docker tag:** Documentation **Host Operating System:** Centos 7 (irrelevant)
kerem 2026-02-26 10:30:54 +03:00
Author
Owner

@ShockwaveNN commented on GitHub (Oct 14, 2021):

I think we do not have enough resources to make all values configurable via ENV since there are hundreds of them

We make all most popular and they described here

I think if you want to be able to configure more - it's two ways

  1. Mount /etc/onlyoffice/documentserver/local.json as volume from the host system and make all necessary changes
  2. Replace it via json command after starting the container in some additional startup script
    like this
docker exec -it DocumentServer /var/www/onlyoffice/documentserver/npm/json -f /etc/onlyoffice/documentserver/default.json -I -e 'this.services.CoAuthoring.autoAssembly.enable=true'
<!-- gh-comment-id:943258475 --> @ShockwaveNN commented on GitHub (Oct 14, 2021): I think we do not have enough resources to make all values configurable via ENV since there are hundreds of them We make all most popular and they described [here](https://github.com/ONLYOFFICE/Docker-DocumentServer#available-configuration-parameters) I think if you want to be able to configure more - it's two ways 1. Mount `/etc/onlyoffice/documentserver/local.json` as volume from the host system and make all necessary changes 2. Replace it via json command after starting the container in some additional startup script like this ``` docker exec -it DocumentServer /var/www/onlyoffice/documentserver/npm/json -f /etc/onlyoffice/documentserver/default.json -I -e 'this.services.CoAuthoring.autoAssembly.enable=true' ```
Author
Owner

@Mr-Philipp commented on GitHub (Oct 14, 2021):

are you sure that the storage-secret doesnt need to be changed inside the nginx config (/etc/onlyoffice/documentserver/nginx/includes/ds-docservice.conf)?

i think so. This is a dissatisfying solution for me because then you also need to mount the nginx config file out of the container.

<!-- gh-comment-id:943329729 --> @Mr-Philipp commented on GitHub (Oct 14, 2021): are you sure that the storage-secret doesnt need to be changed inside the nginx config (/etc/onlyoffice/documentserver/nginx/includes/ds-docservice.conf)? i think so. This is a dissatisfying solution for me because then you also need to mount the nginx config file out of the container.
Author
Owner

@ShockwaveNN commented on GitHub (Oct 14, 2021):

Ok, I've got you
You've meant this string
github.com/ONLYOFFICE/document-server-package@2c204bd51b/common/documentserver/nginx/includes/ds-docservice.conf.m4 (L43)

I see your problem and created issue 53170 for implementing this ability, so set this string via ENV and hard-coding this string is not a good idea

But until we fix it - you should use docker exec method to replace it

<!-- gh-comment-id:943430738 --> @ShockwaveNN commented on GitHub (Oct 14, 2021): Ok, I've got you You've meant this string https://github.com/ONLYOFFICE/document-server-package/blob/2c204bd51ba1118f2715fe9a7d58cfd2286a7a76/common/documentserver/nginx/includes/ds-docservice.conf.m4#L43 I see your problem and created issue 53170 for implementing this ability, so set this string via ENV and hard-coding this string is not a good idea But until we fix it - you should use docker exec method to replace it
Author
Owner

@ShockwaveNN commented on GitHub (Jun 16, 2022):

We added ability to specify this secret via ENV
https://github.com/ONLYOFFICE/Docker-DocumentServer/pull/444

It will be released in next major release, v7.2.0

<!-- gh-comment-id:1157506029 --> @ShockwaveNN commented on GitHub (Jun 16, 2022): We added ability to specify this secret via ENV https://github.com/ONLYOFFICE/Docker-DocumentServer/pull/444 It will be released in next major release, v7.2.0
Author
Owner

@ShockwaveNN commented on GitHub (Sep 23, 2022):

DocumentServer v7.2 is released. This issue should be fixed

Feel free to comment or reopen it if you got further questions

<!-- gh-comment-id:1256410223 --> @ShockwaveNN commented on GitHub (Sep 23, 2022): DocumentServer v7.2 is released. This issue should be fixed Feel free to comment or reopen it if you got further questions
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
starred/Docker-DocumentServer-ONLYOFFICE#198
No description provided.