Skip to content

fix(adminmanual): Clarify frequently asked db replica questions - #15485

Merged
ChristophWurst merged 1 commit into
masterfrom
fix/adminmanual/db-replica-faq-clarification
Aug 25, 2026
Merged

fix(adminmanual): Clarify frequently asked db replica questions#15485
ChristophWurst merged 1 commit into
masterfrom
fix/adminmanual/db-replica-faq-clarification

Conversation

@ChristophWurst

@ChristophWurst ChristophWurst commented Aug 24, 2026

Copy link
Copy Markdown
Member

☑️ Resolves

Clarifies the database replication page (admin_manual/configuration_database/replication.rst) to answer the
questions admins frequently ask about read-only replicas:

  • how read vs. write queries are distinguished and routed (reads → replica, writes → primary)
  • the read-your-writes consistency guarantee and that it is scoped to a single PHP process (one web request, cron
    run, or occ invocation)
  • why the feature needs negligible replication lag, and works best with a synchronous cluster such as Galera
  • that Nextcloud only routes to the endpoints you provide — provisioning, syncing and monitoring replication is the
    DBA's job
  • that a replica is chosen at random, with no weighting or health checks

🖼️ Screenshots

✅ Checklist

  • I have built the documentation locally and reviewed the output
  • Screenshots are included for visual changes
  • I have not moved or renamed pages (or added a redirect if I did)
  • I have run codespell or similar and addressed any spelling issues

Assisted-by: ClaudeCode:claude-opus-4-8
Signed-off-by: Christoph Wurst <1374172+ChristophWurst@users.noreply.github.com>
@ChristophWurst
ChristophWurst force-pushed the fix/adminmanual/db-replica-faq-clarification branch from 293a81d to 56cc6ce Compare August 24, 2026 10:52
@ChristophWurst ChristophWurst self-assigned this Aug 24, 2026
@github-actions

Copy link
Copy Markdown
Contributor

📖 Documentation Preview

🔍 Open preview →

📄 1 changed documentation page

Last updated: Mon, 24 Aug 2026 11:01:45 GMT

@ChristophWurst
ChristophWurst merged commit f716b4e into master Aug 25, 2026
26 checks passed
@ChristophWurst
ChristophWurst deleted the fix/adminmanual/db-replica-faq-clarification branch August 25, 2026 16:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants