nextcloud / nextcloud/docker

Support setting important system configuration values during Docker initialization

Open
#2,427 0 comments 9 reactions 0 assignees View on GitHub

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:

  1. 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
  2. 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

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.