Driver FixRecommendedSound, Wi-Fi or graphics acting up? Check drivers firstFind missing or outdated drivers fast.Check DriversOctober DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsPC HealthRecommendedCrashes, freezes, slowdowns? Check your PC nowSpot repairable issues before they interrupt work.Check PC×
Skip to content
VGSources
Blog

How to Fix Nextcloud Trusted Domains in Docker Compose

The untrusted-domain error is an exact host mismatch. Learn when NEXTCLOUD_TRUSTED_DOMAINS works, how to update trusted_domains with occ, and how reverse-proxy settings differ.
WorldDocker Compose Length6 min Posted Quest giverVGSources Team
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

The “Access through untrusted domain” page means Nextcloud received a Host header that does not exactly match an entry in trusted_domains in config.php. Add the exact hostname users enter in their browsers, including a non-standard port when one is used. For an existing Docker deployment, change the live configuration with occ; changing NEXTCLOUD_TRUSTED_DOMAINS in Compose is generally an initial-setup step.

What the error means

Nextcloud compares the host in each request with its trusted_domains array. If a request arrives for cloud.example.com but that name is absent, Nextcloud blocks the request and displays “Access through untrusted domain.” The comparison is exact: a domain, an IP address, a different subdomain, and a host that includes a non-standard port are distinct entries.

As an Amazon Associate I earn from qualifying purchases.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Start with the URL that the affected user actually enters. If the browser opens https://cloud.example.com, that hostname must be present. If users open https://203.0.113.50, the IP address must also be present. If the public URL uses a non-standard port, include that port in the trusted-domain entry. Do not add a name merely because it appears in your Docker network or proxy configuration; add the name the browser sends in the request.

Choose the right Docker fix

Situation Use What it changes
Brand-new Nextcloud volume and first initialization NEXTCLOUD_TRUSTED_DOMAINS in Compose Seeds the trusted-domain list during initial setup
Existing instance with data already created occ config:system:get and occ config:system:set Edits the live trusted_domains array
Nextcloud is behind a reverse proxy trusted_proxies and the appropriate overwrite settings Defines which proxy may forward requests and corrects detected host, protocol or path

For an instance that already contains users or files, use occ. Treat edits to Compose as configuration for a new volume unless you have verified that your image and deployment process reapplies the variable to an existing configuration.

#1 Best Overall
Sale
Gaoye Blue Light Blocking Glasses
  • BLUE LIGHT BLOCKING GLASSES: Our blue light glasses for women boast UV400 protection, blocking harmful blue rays from computer screens. With these bluelight glasses women, you can enjoy gaming, reading, or watching TV with no worries of eye strain.
  • EYE RELIEF: Our blue light glasses are engineered to reduce blurry vision or strain caused by prolonged screen time. These womens blue light glasses aid in better sleep by preventing blue light from disrupting your natural sleep cycle, helping you fall asleep faster and enjoy a more restful night's sleep, making them the perfect christmas present.
  • COMFORTABLE: Crafted from durable material, our trendy blue light glasses for woman or blue light glasses men ensure long-lasting comfort. The high-transmittance lenses accessories, gamer gifts for men, help keep your eyes relaxed. Perfect stocking stuffers, gifts for gamers men, christmas gifts for men, halloween costumes.
  • LIGHTWEIGHT: These clear blue light glasses feature a lightweight frame, meaning they’ll stay comfy for long-term wear. Perfect as blue blockers glasses for women or mens blue light glasses, these non-prescription fake glasses for men can be worn throughout the day. The blue light blocking glasses women feature polycarbonate HD lenses, which are anti-reflective and restore true color.
  • WORRY-FREE PURCHASE: If you experience any issues, our support team is ready to assist you quickly. These are the perfect costume glasses for cosplay dressing up.

Fix a new deployment with NEXTCLOUD_TRUSTED_DOMAINS

The variable is a space-separated list, not a comma-separated list. A Compose service can be written as:

environment:
  NEXTCLOUD_TRUSTED_DOMAINS: "cloud.example.com 203.0.113.50"

This example permits both the DNS name and the IP address. Replace them with the exact public names your users use. Add each additional hostname separated by a space.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Apply it only while the volume is being initialized

  1. Stop the new stack before its first initialization if it is currently running.
  2. Put the space-separated host list under the Nextcloud service’s environment section.
  3. Start the stack and complete initialization.
  4. Open Nextcloud through every public URL you intend to support and confirm that each one is accepted.

The variable is reported in community deployments as being applied when the Nextcloud volume is first created. On an existing volume, changing the YAML and recreating the container may leave the original trusted_domains array untouched. That behavior is why the live occ method is safer for an established installation.

Fix an existing container with occ

First inspect the current list. Run the command as the web-server user inside the running container:

Rank #2
Windex Gaming Cleaning Wipes, Pre-Moistened Wipes to Instantly Clean all Gaming Gear and Electronics, Resealable Packaging for a Freshness Lock, 25 count (Pack of 1)
  • WINDEX GAMING WIPES: effortlessly clean all your gaming gear and gaming electronics in one easy step with our new Windex Gaming Wipes
  • AMMONIA FREE: our ammonia-free formula is safe to use on all of your favorite gaming equipment like consoles, headsets, controllers, screens, keyboards, and more
  • PRE-MOISTENED WIPES: each wipe instantly removes dust, dirt, and stubborn smudges and fingerprints leaving a streak-free shine
  • ANTI-STATIC: great for cleaning and wiping down your gaming gear and electronics leaving behind no visible residue
  • COMPACT RESEALABLE PACKAGE: store your pack of Windex Gaming Wipes anywhere in your home for whenever a quick and easy wipedown is needed
docker exec --user www-data <container> php occ config:system:get trusted_domains

Replace <container> with the name or ID of your running Nextcloud container. The output shows the indexes already in use. Checking first matters because setting a value at an occupied index replaces that value.

Add a hostname at a free index

For example, to write cloud.example.com at index 1:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
docker exec --user www-data <container> php occ config:system:set trusted_domains 1 --value=cloud.example.com

Use the next unused numeric index from the inspection output. If index 1 already contains a host you still need, choose another free index instead of overwriting it.

Add an IP address or another public name

Run the same command with another unused index and the exact value users enter:

Rank #3
Sale
LISEN Cell Phone Stand Phone Holder for Desk, Office Decor Gadgets for Men
  • Ergonomic & Adjustable Design: Fight "text neck" and improve your posture. Designed for comfort, it offers an adjustable height (7.1in-8.5in) (1.4in adjustable range) and angle (5°-85°) Please note: cell phone stand is only 9 inches tall—the length of a standard pencil
  • Without blocking subtitles Perfect for office desk Tiktok Face Time Zoom video—this is the ultimate kitchen desk essential for phones! Perfect viewing experience while reducing neck back strain, A must-have for gamers streamers desk, and anyone who values both style and support!
  • Sleek & Stable Design fits Otterbox Case: Say goodbye to bent cables, tangles, and tip-overs! LISEN’s stylish adjustable desk phone holder features a built-in charging hole and smart cable management, keeping your phone secure and your workspace clutter-free cool gadgets for men
  • ANTI-SLIP DESIGN free hands: The under 10.00 items easy gadgets back and the bottom of this kitchen essentials for women are fully covered by anti-skid silicone, which LISEN stand up desk decor can provide maximum protection device from any scratches and slides
  • Your Perfect Viewing Companion:If your product arrives damaged or breaks within 365 days, reach out to LISEN for a quick and hassle-free solution. Struggling with assembly, like tightening the screw? We’ve got your back! Your experience matters to us. (Product including: phone Holder stand*1, screw*1, hexagon screwdriver*1, specification*1)
docker exec --user www-data <container> php occ config:system:set trusted_domains 2 --value=203.0.113.50

Repeat one command per additional hostname. Keep the entries that are already valid; adding a new value does not require removing them.

Verify the resulting array

  1. Run docker exec --user www-data <container> php occ config:system:get trusted_domains again.
  2. Confirm that every browser-facing hostname appears at its own index.
  3. Retry the URL that produced the warning.
  4. Test each alternate public URL separately, because a successful DNS name does not prove that an IP address or second domain is listed.

Do not solve a proxy problem by adding the proxy as a trusted domain

A reverse proxy introduces a separate trust decision. Nextcloud’s trusted_proxies setting identifies proxy addresses that are allowed to forward requests. The proxy’s own address is not automatically a trusted domain. Add it to trusted_domains only if a browser genuinely reaches Nextcloud by using that address as its hostname.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

When overwrite settings are needed

Nextcloud can derive the host, protocol and path from forwarded headers. If that detection is wrong, the reverse-proxy configuration documents these settings:

  • overwritehost forces the public host name.
  • overwriteprotocol forces the public scheme, such as HTTPS.
  • overwritewebroot forces the public path when Nextcloud is mounted below a URL prefix.
  • overwrite.cli.url sets the canonical URL used by command-line operations.

Use these settings for incorrect redirects, generated links or protocol warnings. They do not replace adding the browser-facing host to trusted_domains. A proxy-header warning has also been tracked in the Docker project (issue #1384), which illustrates why proxy trust and domain trust should be diagnosed separately.

Rank #4
Ledagic IC+RGBW USB Powered Led Light Bar with App & Remote Control, 2 Pack
  • Easy Installation: Our gaming lights have been designed to enhance your entertainment experience. Simply position the led light bar next to your TV or game console to create a game room environment with ease. They come with USB power and a 60 inch cord for direct mounting and mobility
  • Audio Syncing & Extensive Mode: The built-in high-sensitivity music sensor allows you to sync the TV led lights to your favorite music. Lights react and move to the beat of music, film and game audio, creating an incredible immersive sound and light experience – and all without the need for an additional hub. You can choose from 64+ patterns, including strobe, illusion, jump, energy, gradient, running, chasing, fluttering mode etc. Each mode can be applied to different scenes
  • 64+ Chasing IC+RGB & W Effect: The independent control design of IC+RGB and white all-in-one multifunctional rgbw led bar lights monitor backlight allows you to easily switch the led lights for desk between IC+RGB and white to enjoy a variety of lighting effects, you can choose white lighting mode with high brightness for better illumination when working, etc. Choose IC+RGB lighting mode when you need to create an entertaining atmosphere for the light show, 16 million colours of Color changing rgb light bar let you dance to the beat and create a dynamic party atmosphere
  • Dynamic and Dimmable Lights: 1%-full brightness free brightness adjustment gives you the flexibility to adjust dimmable led light bar for room decorations or a variety of occasions
  • USB Powered: USB light bars for room can be powered by powernank, usb charger, TV, Monitor, laptop PC mainframe, making behind TV led lighting bar easy to install in any location.TV led lights are powered by the TV usb interface / PC mainframe, can be turned on/off synchronously with TV / PC

Why changing Compose may appear to do nothing

Several Docker community reports describe NEXTCLOUD_TRUSTED_DOMAINS changes that did not update an existing installation. The reported workaround was deleting the Nextcloud volume so initialization would run again, but that removes the instance’s stored data. It is a destructive reset, not a normal configuration procedure.

  • Do not remove a production volume merely to force an environment variable to be reread.
  • Back up the database and files before any volume operation.
  • For an existing volume, inspect and edit the live array with occ.
  • If you intentionally rebuild, verify the backup by restoring it before treating the old volume as disposable.

Docker issue #582 is titled “Trusted domain not working with docker compose,” and issue #1011 is titled “trusted_domains NOT working (UI unreachable).” Their existence is a reminder to distinguish an initialization-time variable from a live configuration edit and to keep a recovery plan.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Systematic troubleshooting checklist

1. Copy the browser’s actual host

Read the address bar, including the subdomain and any non-standard port. Do not rely on the container name, an internal service name or the proxy’s private address.

2. Compare it with the live list

Run config:system:get trusted_domains inside the running container. Look for spelling, subdomain and port differences. A value for example.com does not automatically cover cloud.example.com, and an entry without a non-standard port does not establish that port-specific URL.

Best Value
Sale
HUANUO FlowLift™ Dual Monitor Stand, Fully Adjustable Gaming Monitor Desk Mount for 13–32″ Computer Screens, Full Motion VESA 75x75/100x100 with C-Clamp & Grommet Base, Each Arm Holds 4.4 to 19.8 lbs
  • Compatible with Wide Screens - To ensure compatibility with the dual monitor mount, your each monitor must meet three conditions at the same time: First, computer screens size range: 13 to 32 inches. Second, screen weight range: 4.4 to 19.8 lbs. Third, the back of the monitor screen must have VESA mounting holes with a pitch of 75x75mm or 100x100mm.
  • Regarding the compatibility with desks - Your desk must meet three conditions at the same time: First, desk material: Only wooden desks are recommended, plastic or glass desks cannot be used. Second, desk thickness range: 0.59" - 3.54". Third, the bottom of the desk should not have any cross beams or panels, as this will interfere with installation. We recommend carefully checking that your desk and monitors meets all above conditions before purchasing.
  • Dual C-Clamp Hold - Worried your dual monitors might wobble or slip? Our upgraded base uses a larger platform plus a dual C-clamp structure to lock the dual monitor arm firmly to your desk. Each arm safely keeps your screens steady while you type, click and game—no shaking, no sliding, just a clean and secure setup you can trust every day. It also provides Grommet Mounting installation choice, both options ensure stable and secure fixation for your 0.59" - 3.54" desk.
  • Full-Motion Adjustment For Comfortable View - Pull the screen closer when you’re deep in a spreadsheet, push it back to watch videos, or rotate to portrait for coding — moving everything smoothly with just one hand. The monitor stand offers +85°/-50° tilt, ±90° swivel and 360° rotation. Raise your monitor up to 15.75″ to support a healthy sitting posture. Whether you’re working from home, gaming through the night, or switching between video calls and documents, getting the screens to your natural line of sight helps relieve neck, shoulder and back strain so you can stay focused longer with less fatigue.
  • Keep Your Desk Organized: By lifting both screens off the desktop, this dual monitor stand opens up valuable space for your keyboard, notebook, docking station or a simple, clutter-free work area. Built-in cable management guides wires along the arms, keeping cords out of sight and out of the way. Enjoy a tidy, modern workstation that looks as good as it feels to use.

3. Add rather than overwrite

Select an unused numeric index and run config:system:set. Writing to an index already in use replaces that entry, so inspect first.

4. Check proxy settings independently

If the host is correct but redirects, HTTPS detection or a subdirectory path is wrong, review trusted_proxies and the relevant overwrite setting. Do not broaden trusted_domains with internal proxy addresses as a substitute.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

5. Test every entry

Open each supported public URL in a browser. This catches a missing alternate domain even when the primary address works.

6. Treat multi-domain reports cautiously

Forum users have reported cases in which only the first value in a multi-domain NEXTCLOUD_TRUSTED_DOMAINS list was applied. That report is not verified here against the current image. If several domains matter, verify the resulting array with occ and add missing entries individually rather than assuming the Compose list was consumed correctly.

Common mistakes and their corrections

  • Using commas in the environment variable: use spaces between values.
  • Adding the Docker service name: add the hostname visible to the browser instead.
  • Changing YAML on a mature installation: edit the live configuration with occ.
  • Overwriting index 1: inspect the array and choose an unused index.
  • Adding only the proxy address: configure trusted_proxies; add a proxy address as a domain only when users browse to it.
  • Deleting the volume as a first resort: preserve backups and use occ unless you are deliberately rebuilding and have a tested restore.

Operational guidance for a durable setup

Document the public URLs your deployment supports and keep the Compose file, proxy configuration and Nextcloud configuration aligned. When a new domain is introduced, add it deliberately, verify the live array, and test the URL before directing users to it. Keep internal routing details separate from browser-facing names: trusted_domains answers “which host may users request?”, while trusted_proxies answers “which intermediary may forward that request?”

This separation also makes future migrations safer. You can change a proxy or container address without changing the public domain, and you can add a second public domain without trusting every internal network address.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More quests from Patch Notes

  1. How to Set Up a RedM (RDR2) Server in 2026: License Key, txAdmin and server.cfg, Step by StepBlog11min
  2. Best RedM (RDR2) Server Hosting in 2026: Comparing Four Hosts on Slots, Memory and PriceBlog10min
  3. How to Host a Mindustry Server in 2026: server-release.jar, Port 6567 and the Commands That MatterBlog7min
Recommended PC Tool
Recommended PC Tool
Outdated Drivers Are Slowing You DownFree scan - exact matches
Windows Errors? Fix Them Before They SpreadFree repair scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.