// troubleshooting guide · seafile

Seafile Not Freeing Disk Space

Status
Workaround available
platforms:
Self-hosted server
updated:
November 16, 2026
reports:
5
Method
how we research
Share

RUNBOOK · seafile/disk-space-not-freed3 FIXES

// quick answer

Deleting files doesn't remove their blocks; garbage collection does, and only for blocks no longer referenced by history or deleted libraries. Shorten history, run GC (dry run first), and include deleted libraries.

Most likely fix: Shorten file history

How to fix it

// try these in order, the most common fix is first

  1. FIX 1Shorten file history

    1. 01In the library settings (or seafile.conf defaults) lower how long history is kept
    2. 02Empty the library recycle bin for files you no longer need
    Did this fix it?
  2. FIX 2Run garbage collection

    1. 01Docker: docker exec seafile /scripts/gc.sh (it stops and restarts the service)
    2. 02Binary installs: stop Seafile, run ./seaf-gc.sh --dry-run to see libraries with garbage, then ./seaf-gc.sh
    3. 03Community Edition must be stopped during GC; Pro can run it online except with SQLite
    Did this fix it?
  3. FIX 3Clean up deleted libraries

    1. 01Clear deleted libraries from the admin trash
    2. 02Run GC with the option that removes blocks of deleted libraries (see seaf-gc.sh --help)
    3. 03Never delete folders in storage/blocks by hand unless you've confirmed the library no longer exists
    Did this fix it?

SANDBOX · seafile RUNS IN YOUR BROWSER

Try it: upload, share and sync files between the web and your laptop

A hands-on Seafile-style sandbox, including the spots where users get stuck. See where problems like this one start. 1-2 minutes, nothing is saved.

Symptoms

Storage on disk keeps growing or stays the same after deleting files or whole libraries; disk usage is far above what the admin panel shows.

Why it happens

  • C-01Blocks only removed by the garbage collection script
  • C-02File history and snapshots keeping old blocks alive
  • C-03Deleted libraries still in the trash or database
  • C-04GC not run, or run while the Community server was online

// this guide also covers

  • seafile disk space not freed
  • seafile gc not freeing space
  • seafile storage growing
  • seafile garbage collection

Still not working?

If Seafile keeps failing, you're not alone. See every Seafile 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 Seafile 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 storage, upload & download guides →

Other Seafile errors

All 11 Seafile errors and fixes →