Adding a new trusted domain


Trusted domains are used by Nextcloud to prevent Host Header Poisoning. You need to specify every domain at which your Nextcloud can be accessed.

This means if you have Nextcloud installed at “” and also want it to be accessible at “” you’d need to modify the trusted_domains entry in your config/config.php. The initial config would look like the following:

  'trusted_domains' =>
  array (
    0 => '',

To add a new domain just add new entries by appending a new item to the PHP array:

  'trusted_domains' =>
  array (
    0 => '',
    1 => '',

If you use an environment where your IP address can change multiple times it is recommended to configure your DNS server in a way to resolve to the IP instead of accessing the IP address manually.

Note: Nextcloud is optimised for usage with just a single domain. It is thus recommended to stay with just one domain instead of using multiple ones.

Add all private IPs (local network) to Trusted Devices
Error url trusted_domains
NextCloud Box - Use of static IP address
Trouble connecting to local Nextcloud box through wifi with android
How to add domain name to nextcloud
Remote and local server setup?
Can't set new trusted-domain without a blank page
Error 500,503 on fresh installation
No access after config.php change, php error, http error 500, SimpleContainer.php:110 error
NextCloud 11 ready Raspbian image with extras

Thought I would simply give a thanks @LukasReschke (& all devs/contributors) . I just created my v10 instance and all is working great.

I take a look at the logs and within 10 hours of set up on a new hosted server, IP and install I had someone attempt this on my server.

With that said, it would be a interesting feature to add these IPs to a block list as outlined here automatically:

& for nginx folks

… OR to a NC community/crowd-sourced database of bad bots/IPs (with fail2ban?).

With peace-of-mind, I’m moving on and grateful for the awesome work. :+1:


I just wanted to add that adding a trusted domain can also easily be done from the command line:

# sudo ./occ config:system:set trusted_domains 2 --value=your.domain


oparoz, would this work within the command line of freenas?


Hi Lukas,

I’m newbie in linux
How to modify config.php?
I have to add new domain but config.php can’t open.
How to modify file/folder permissions?

Please advise



Hello @sudarjito,

You must open the file as a super user in order to modify it. For example, if you are using Ubuntu the command to do that is:

$sudo gedit /path/to/your/config/config.php

Although the given example works in Ubuntu, the command shall work well in any system that you have a super user access and gedit installed.


Hy, i have the Same problem, Need some help.
I have to do Config the Config.php to add my trusted domain

I dont know where i find the file/path to edit it.


it probably depends on the system you are using.
On my debian-install it’s

Edit the file using admin-rights.



I got problem to config “Add Trusted Domain” in Own Cloud using Cent OS.
I hope you guys have the solution. tq


hello - i’m new inhere …

  • i’ve installed ‘nextcloud’ on a centos-7, under /var/www/html/ …

  • but now i’ve got a new different fixed ip-address from my ‘isp’ - so how
    do i change to the new ip-addr. without ‘messing’ my current build/setup?




Why would you do that?

On the other hand, its just a foldername, and therefore a bad design desicion, but who cares. I allways use /var/www/nextcloud.

You can just leave this (changes here are not recommended). What really counts here is your DNS setup and config.php, since DNS virtualises IP adresses away for that manner.

Supplement: What does 192.168.* has to do with your ISP? What the … ?


To not open a new thread about the same, I added…

sudo nextcloud.occ config:system:set trusted_domains 1 --value=
System config value trusted_domains => 1 set to string

sudo nextcloud.occ config:system:get trusted_domains

But nextcloud insist to add the IP to trusted domains.


No idea about that?


I have the same problem with Giu.
I added a new router and created a bridge connection with my old one which I changed the mode to modem.
After doing that I connected my raspberrypi, where I have the nextcloud installed, to my new router and then I got this screen to add the new ip to the trusted_domains list in config.php.
I did it and still getting the same message.
Any help would be appreciated.


If you’re on a Snap installation, it’ll probably be here:



I installed Nextcloud 14 from a snap (in Debian 9), so in my case, I had to use the command, as root:

nextcloud.occ config:system:set trusted_domains 2