// troubleshooting guide · owncloud
ownCloud File Is Locked (Server Replied 423 Locked)
- Status
- Workaround available
- platforms:
- Self-hosted ownCloud Classic
- updated:
- November 16, 2026
- reports:
- 4
- Method
- how we research
RUNBOOK · owncloud/file-is-locked-4235 FIXES
// quick answer
A stale lock from a crash or interrupted scan blocks the file. Make sure cron runs so locks expire, run occ maintenance:repair, and use Redis for transactional file locking.
Most likely fix: Run background jobs with cron
How to fix it
// try these in order, the most common fix is first
FIX 1Run background jobs with cron
- 01In Settings > Admin > General, set Background jobs to Cron
- 02Add a crontab entry for the web user running php occ system:cron (or cron.php) every 15 minutes
Did this fix it?FIX 2Run a repair
- 01Run: sudo -u www-data php occ maintenance:repair
- 02Retry the sync
Did this fix it?FIX 3Clear locks manually
- 01Enable maintenance mode: occ maintenance:mode --on
- 02Back up the database, then delete rows from the oc_file_locks table
- 03Turn maintenance mode off
Did this fix it?FIX 4Use Redis for file locking
- 01Install Redis and the PHP redis extension
- 02Set 'memcache.locking' => '\OC\Memcache\Redis' and the redis host in config.php
Did this fix it?FIX 5Update the server
- 01Upgrade to the latest 10.16.x or 11.0 release; several locking bugs were fixed over time
Did this fix it?
Symptoms
The desktop client shows 'Server replied 423 Locked' on PUT or DELETE, or the web UI says a file is locked and can't be changed.
Why it happens
- C-01Lock left behind by a crashed upload or interrupted file scan
- C-02Background jobs (cron) not running, so locks never expire
- C-03Database-based locking under heavy sync load
- C-04Old ownCloud versions with locking bugs
// this guide also covers
- owncloud 423 locked
- owncloud file is locked
- server replied 423 locked owncloud
- owncloud unlock file
Still not working?
If ownCloud keeps failing, you're not alone. See every ownCloud 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 →
Nextcloud Upload Size Limit and 413 Error (Nextcloud)
Syncthing Failed to Start Filesystem Watcher (Syncthing)
Dropbox Basic 3 Device Limit Reached (Dropbox)
Other ownCloud errors
- ownCloud Desktop Client Not Syncing
- ownCloud Desktop App 7 Not Connecting to ownCloud Server
- ownCloud Access Through Untrusted Domain Error
- ownCloud Large File Upload Fails (413 Request Entity Too Large)
- ownCloud Stuck in Maintenance Mode After Update
- ownCloud Integrity Check Failed (Some Files Have Not Passed)
- ownCloud Unable to Open or Create the Local Sync Database
- ownCloud Virtual Files Not Working on Windows