Nextcloud Not Working? Common Errors & Fixes
The 10 Nextcloud problems users hit most often, why they happen, and the fixes that actually work — collected from user reports, forums, and official support docs.
Nextcloud Access Through Untrusted Domain Error
Workaround availableSelf-hosted (Docker, TrueNAS, Linux)Nextcloud refuses requests whose hostname is not in trusted_domains. Add the domain or IP to config.php (or via occ), and behind a reverse proxy also set trusted_proxies and overwrite settings.
Why Is Nextcloud So Slow?
Workaround availableSelf-hostedSlow Nextcloud is usually missing memory cache, untuned OPcache, SQLite or a PHP-FPM pool that is too small. Enable APCu/Redis, switch to MariaDB or PostgreSQL and use system cron.
Nextcloud Upload Size Limit and 413 Error
Workaround availableSelf-hosted, web, desktop, WebDAVLarge uploads fail when PHP, the web server, a reverse proxy or Cloudflare caps the request size. Raise limits at every layer and lower the client chunk size if a CDN caps at 100 MB.
Nextcloud Desktop Client Sync Slow
OngoingWindows, macOS, LinuxSync of many small files is slow by nature; check client bandwidth limit, antivirus scanning and server tuning first.
Nextcloud Sync Error: Connection Closed
Workaround availableDesktop, self-hosted'Connection closed' on large files is usually chunk size or timeouts; adjust client chunk settings and check proxy limits.
Nextcloud File Is Locked (423) Error
Workaround availableSelf-hostedStale locks left by interrupted uploads cause 423 errors. Clear stale locks, use Redis for locking, and run occ maintenance:repair.
Nextcloud Stuck in Maintenance Mode
Workaround availableSelf-hostedAn interrupted update leaves Nextcloud in maintenance mode. Turn it off with occ and rerun occ upgrade.
Nextcloud Internal Server Error After Update or App Install
Workaround availableSelf-hostedA 500 error is usually a failing app, so read the Nextcloud log and disable the culprit app with occ.
Nextcloud Client CSync Unknown Error
Workaround availableWindows, macOS, LinuxA corrupted local sync journal causes this; stop the client, delete the hidden .sync_*.db file and restart.
Nextcloud iOS App Locked File or Upload Errors
Workaround availableiOS, WebDAViOS and WebDAV apps hit 423 Locked and large-upload errors; clear stale locks and raise proxy limits.
Problem not listed? See all Nextcloud complaints or compare Nextcloud alternatives.
// We build software. Any software.
Have an idea for an app? We'll build it.
We're a small team of developers who build custom software fast. Not just tools like Nextcloud: web and mobile apps, games, desktop software, AI tools, internal tools: whatever you have in mind. 50+ custom products built for clients so far, and we run our own products too: booking platforms, games, learning apps. See our work
- Web apps & SaaS
- Mobile apps (iOS & Android)
- Games
- Desktop software
- AI tools & automations
- Internal tools & dashboards
- Client portals & booking
- Your own version of any tool
- ✓ Free 15-min call to scope it
- ✓ Price agreed up front
- ✓ Your data, your code