Support setting important system configuration values during Docker initialization
Nobody has claimed this yet.
- Dominant language
- Shell
- Stars
- 7.4k
- Forks
- 1.9k
- PR merge metrics
- No merged PRs in 30d
Description
When deploying Nextcloud using the official Docker image, certain important system configuration values are not set by default, resulting in warnings or suboptimal behavior even after a clean installation. Two common examples are:
- maintenance_window_start
Fresh installations display this warning in the system overview: "Server has no maintenance window start time configured."
There is currently no way to set this value during the Docker-based setup. Instead, it must be configured manually via OCC:./occ config:system:set maintenance_window_start --type=integer --value=1 - default_phone_region
Fresh installations display in the system overview: "Your installation has no default phone region set"
There is currently no way to set this value during the Docker-based setup. Instead, it must be configured manually via OCC:./occ config:system:set default_phone_region --value="DE"
Expected Behavior
A fresh Nextcloud Docker installation should result in a fully configured, clean state, without requiring manual OCC calls for essential system settings.
Proposed Solution A
Introduce environment variables that allow setting all values at container startup which can result in warnings or messages on the "Security & setup warnings" page.
environment:
- NEXTCLOUD_DEFAULT_PHONE_REGION=DE
- NEXTCLOUD_MAINTENANCE_WINDOW_START=1
Proposed Solution B
Offer a documented and supported way to inject occ commands during first-time initialization.
Impact
- Reduces post-installation steps
- Improves automation and reproducibility
- Avoids confusing warnings for new users
- Aligns with Docker/container best practices
Thanks for your time and for maintaining the Docker image!
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the Docker-based first-time initialization flow and the OCC commands shown in the issue. Compare the two proposed approaches for setting maintenance_window_start and default_phone_region, then determine which configuration path is supported. Done means a fresh Docker installation can configure these values without manual post-installation OCC calls.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- docker, shell
- Domain
- devops, infrastructure
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Stale
- Clarity
- Needs clarification
- Newbie friendliness
- 30/100