Instructions for domain change

[Sommerwiesel]

Add instructions for a domain change.

☑️ Resolves

• Gives users instructions on how to perform a domain change
• I have fully tested the method on my production nextcloud with many many apps and many many fiiles and there are no problems

[joshtrichards]

Hi @Sommerwiesel - Thanks for the addition! I agree it's easy enough to add/change domains by merely adding them to trusted_domains, but I'm not sure about this because it gets more complicated when client apps are involved as well as for some server-side apps.

Server-side apps: Some will break and require re-configuration or config resets. social (requires a full config reset), notify_push (if not configured to use config.php), and richdocuments (if used with richdocumentscode) come to mind. Possibly some of the authentication apps. On the other hand, that's always the case I suppose and we can't cover all apps/scenarios. Plus admin's should expect there will be other spots they need to change domain references I guess (theming and spreed/talk?).

Clients (desktop, mobile): Will not accept a domain change. New account profiles must get created. Data will have to be re-synced. Profile options will have to be re-entered.

Also, AFAIK even with redirects in place existing shares will break (same as when multiple distinct domains are in-use I presume - #11623).

I just don't want to mislead people that it's just that easy since it's more along the lines of it might be easy, but it depends. :-)

Which doesn't mean we can't document precisely that I guess. 🤔

Those are my initial thoughts.

[kesselb]

I changed the domain for my Nextcloud instance a while ago and found the domain name a couple of times in the database. phpMyAdmin's search feature was really helpful back then.

The domain name is used in oc_circles_event (instance name) and oc_circles_member (note) at least.

[szaimen]

The domain name is used in oc_circles_event (instance name) and oc_circles_member (note) at least.

There are even more places, e.g. look here: https://github.com/nextcloud/all-in-one?tab=readme-ov-file#how-to-change-the-domain

[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!