// troubleshooting guide · nextcloud
Nextcloud File Is Locked (423) Error
- Status
- Workaround available
- platforms:
- Self-hosted
- updated:
- November 16, 2026
- reports:
- 3
- Method
- how we research
RUNBOOK · nextcloud/file-locked-4234 FIXES
// quick answer
Stale locks left by interrupted uploads cause 423 errors. Clear stale locks, use Redis for locking, and run occ maintenance:repair.
Most likely fix: Run repair commands
How to fix it
// try these in order, the most common fix is first
FIX 1Run repair commands
- 01Run occ maintenance:repair
- 02Run occ files:scan --all and occ files:cleanup
Did this fix it?FIX 2Clear stale locks
- 01Back up the database
- 02Enable maintenance mode
- 03Delete rows from the oc_file_locks table
- 04Disable maintenance mode
Did this fix it?FIX 3Configure Redis for locking
- 01Install Redis
- 02Set memcache.locking to the Redis backend in config.php and verify the connection
Did this fix it?FIX 4Last resort
- 01Disable file locking only on single-user instances, as a temporary workaround
Did this fix it?
Symptoms
Files cannot be edited, deleted or synced; the client logs Server replied 423 Locked.
Why it happens
- C-01Interrupted upload or crashed PHP worker
- C-02Database file locking left stale rows
- C-03Misconfigured Redis locking
- C-04Very long uploads (over an hour)
// this guide also covers
- nextcloud file is locked
- nextcloud 423 locked
- nextcloud unlock file
Still not working?
If Nextcloud keeps failing, you're not alone. See every Nextcloud problem users report or the alternatives people switch to.
Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.
Talk to usThe same problem in other apps
All plan limits, paywalls & watermarks guides →
Dropbox Basic 3 Device Limit Reached (Dropbox)
Other Nextcloud errors
- Nextcloud Access Through Untrusted Domain Error
- Why Is Nextcloud So Slow?
- Nextcloud Upload Size Limit and 413 Error
- Nextcloud Desktop Client Sync Slow
- Nextcloud Sync Error: Connection Closed
- Nextcloud Stuck in Maintenance Mode
- Nextcloud Internal Server Error After Update or App Install
- Nextcloud Client CSync Unknown Error