[whoalin1]

Summary

Closes #15195

Document that when Nextcloud itself is offline, answering client endpoints with HTTP 503 lets desktop/mobile clients treat the instance like maintenance mode. Point admins at occ maintenance:mode for in-app maintenance.

Test plan

• Docs build for admin_manual/maintenance/index.rst
• New section mentions HTTP 503 and occ maintenance:mode

---

AI disclosure

This PR was drafted with the help of AI coding assistants (Cursor agents / LLM-based tools), including the description. I am responsible for it and happy to rework anything that doesn't fit.

All commits carry an Assisted-by: Cursor:grok-4.7 trailer.

[skjnldsv]

Closing, because this would document behaviour the desktop client doesn't have. It only detects maintenance from "maintenance": true in a 200 status.php response. Any non-200 reply is treated as "server not found": https://github.com/nextcloud/desktop/blob/master/src/libsync/networkjobs.cpp#L688-L692

That matches what the reporter saw in #15195: after the 503 the client showed the server as offline, not in maintenance. So a 503 does not give you the maintenance mode behaviour, and we shouldn't recommend it.

[github-actions]

Hello there,
Thank you so much for taking the time and effort to create a pull request to our Nextcloud project.

We hope that the review process is going smooth and is helpful for you. We want to ensure your pull request is reviewed to your satisfaction. If you have a moment, our community management team would very much appreciate your feedback on your experience with this PR review process.

Your feedback is valuable to us as we continuously strive to improve our community developer experience. Please take a moment to complete our short survey by clicking on the following link: https://cloud.nextcloud.com/apps/forms/s/i9Ago4EQRZ7TWxjfmeEpPkf6

Thank you for contributing to Nextcloud and we hope to hear from you soon!

(If you believe you should not receive this message, you can add yourself to the blocklist.)