// 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
Share

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

  1. FIX 1Run background jobs with cron

    1. 01In Settings > Admin > General, set Background jobs to Cron
    2. 02Add a crontab entry for the web user running php occ system:cron (or cron.php) every 15 minutes
    Did this fix it?
  2. FIX 2Run a repair

    1. 01Run: sudo -u www-data php occ maintenance:repair
    2. 02Retry the sync
    Did this fix it?
  3. FIX 3Clear locks manually

    1. 01Enable maintenance mode: occ maintenance:mode --on
    2. 02Back up the database, then delete rows from the oc_file_locks table
    3. 03Turn maintenance mode off
    Did this fix it?
  4. FIX 4Use Redis for file locking

    1. 01Install Redis and the PHP redis extension
    2. 02Set 'memcache.locking' => '\OC\Memcache\Redis' and the redis host in config.php
    Did this fix it?
  5. FIX 5Update the server

    1. 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 us

Watch ownCloud Get an email when its price changes, it has an outage, or we publish a new fix. No spam.

Fixed it? Share this guide

The same problem in other apps

All plan limits, paywalls & watermarks guides →

Other ownCloud errors

All 12 ownCloud errors and fixes →