docs: add warnings about IP address and self-signed certificate limitations#7693
Open
tjaadvd wants to merge 1 commit intonextcloud:mainfrom
Open
docs: add warnings about IP address and self-signed certificate limitations#7693tjaadvd wants to merge 1 commit intonextcloud:mainfrom
tjaadvd wants to merge 1 commit intonextcloud:mainfrom
Conversation
…ations Signed-off-by: tjaadvd <[email protected]>
pabzm
requested changes
Mar 13, 2026
Member
pabzm
left a comment
There was a problem hiding this comment.
Thank you for the contribution!
I like the idea but would like to ask you for two text changes. Thanks!
| # Local instance | ||
|
|
||
| > [!WARNING] | ||
| > AIO requires a **real domain name** and a **valid TLS certificate** to function correctly. |
Member
There was a problem hiding this comment.
- "real domain name" is not very precise, our requirement is "publicly resolveable domain" (or hostname). That's not as catchy, if you can think of another wording, please let me know. But please replace "real".
- Technically a self-signed certificate is also valid. You (probably) correctly mean a publicly verifiable certificate (issued by a well-known, public certificate authority), so please change the phrase accordingly.
Author
There was a problem hiding this comment.
Hi,
I'm having trouble coming up with the correct text. What do you think about this?
# Local instance
> [!WARNING]
> AIO requires a **publicly resolvable domain** and a **publicly verifiable certificate** (issued by a well-known, public certification authority).
|
|
||
| > [!WARNING] | ||
| > AIO requires a **real domain name** and a **valid TLS certificate** to function correctly. | ||
| > Accessing Nextcloud via a plain IP address or a self-signed certificate is **not supported**. |
Member
There was a problem hiding this comment.
Using a local CA is also unsupported.
Author
There was a problem hiding this comment.
How about this?
Accessing Nextcloud via a **plain IP address**, a **self-signed certificate**, or a **certificate from a local certificate authority (CA)** is **not supported**.
39 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Many users attempt to run Nextcloud AIO on a local network using an IP address or a self-signed certificate, only to discover this is unsupported after going through the setup process. I personally tried this too, even though i (quickly) read the README and Local-instance pages.
This PR makes the limitation more visible upfront so others won't make the same mistake.
Changes
local-instance.md: Added a[!WARNING]callout at the top of the page clearly stating that AIO requires a real domain name and a valid TLS certificate, and that IP addresses and self-signed certificates are not supported.readme.md: Added a[!WARNING]callout in the "How to use this?" section directing local-only users tolocal-instance.mdbefore proceeding with setup.Motivation
The existing documentation mentions these limitations, but only in passing within a longer paragraph. Users who skim the docs (or jump straight to the setup steps) miss this entirely. The new callouts ensure the constraint is visible before any setup steps are taken.