// 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
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
FIX 1Shorten file history
- 01In the library settings (or seafile.conf defaults) lower how long history is kept
- 02Empty the library recycle bin for files you no longer need
Did this fix it?FIX 2Run garbage collection
- 01Docker: docker exec seafile /scripts/gc.sh (it stops and restarts the service)
- 02Binary installs: stop Seafile, run ./seaf-gc.sh --dry-run to see libraries with garbage, then ./seaf-gc.sh
- 03Community Edition must be stopped during GC; Pro can run it online except with SQLite
Did this fix it?FIX 3Clean up deleted libraries
- 01Clear deleted libraries from the admin trash
- 02Run GC with the option that removes blocks of deleted libraries (see seaf-gc.sh --help)
- 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 usThe same problem in other apps
Other Seafile errors
- Seafile 403 CSRF Verification Failed
- Seafile 502 Bad Gateway After Upgrade
- Seafile Client Not Syncing
- Seafile 'Error When Indexing' / Failed to Index File
- Seafile Upload Failed for Large Files (413 Error)
- Seafile OnlyOffice 'Download Failed' Error
- Seafile Pro Shows Community Edition After Upgrade
- Seafile Encrypted Library Forgot Password