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

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

  1. FIX 1Run repair commands

    1. 01Run occ maintenance:repair
    2. 02Run occ files:scan --all and occ files:cleanup
    Did this fix it?
  2. FIX 2Clear stale locks

    1. 01Back up the database
    2. 02Enable maintenance mode
    3. 03Delete rows from the oc_file_locks table
    4. 04Disable maintenance mode
    Did this fix it?
  3. FIX 3Configure Redis for locking

    1. 01Install Redis
    2. 02Set memcache.locking to the Redis backend in config.php and verify the connection
    Did this fix it?
  4. FIX 4Last resort

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

Watch Nextcloud 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 Nextcloud errors

All 10 Nextcloud errors and fixes →