Please check the status of this specification in Launchpad before editing it. If it is Approved, contact the Assignee or another knowledgeable person before making changes.


This spec describes a tool that helps the user to free disk space by offering to remove temporary files.

Release Note

A new tool that helps freeing up diskspace is now part of the default install.


If a machine runs low on disk space the user is on his own. There is no good GUI tool to help him freeing space. The "system-cleanup" tool addresses this issue.

Use Cases

  1. Alice runs out of disk space because her apt cache is too big
  2. Bob has a very small /boot partition and with the addition of new kernels it eventually runs out of space.


The tools needs to be written in a way that makes it easy to add new GUI frontends (like qt/text) and to make it very easy to add custom free space plugins to make community participation easy.

When gnome-volume-manager (or kded) detect that the disk space runs low, it pops up a notification. This notification should include a button to launch the system-cleanup helper with the appropriate filesystem that is low on disk space. The user-cleanup helper should also be run when the disk quota is full.

Some of the areas where space can be freed require administrative privileges. We will only show them if the user is in the admin group (or the distro specific equivalent).

Possible targets:

Depending on the partition layout the tool needs to make intelligent decisions. E.g.:

Additionally it should offer to run something like "fdupes" to find duplicated files in the users home directory. If the tool runs out of ideas, it should offer to run baobab and let the user continue the cleanup manually.

It is important that we ensure that it is possible to login into gnome even if $HOME is full. We should add a automatic test for this.


Each cleanup target is implemented as a plugin. The directory with the mount point that runs low on disk space is passed to the plugin and it then declares how much space it can free where (symlinks needs to be considered too). Support for a global plugin directory where applications can store plugins (e.g. opera to delete its own cache) as well as user plugins should be added.

Test/Demo Plan


This need not be added or completed until the specification is nearing beta.

Releated Work

Outstanding Issues

BoF agenda and discussion

gnome-volume-manager has some heuristics to take the velocity of disk-fill up into account (do some learning here to try to figure out the users disk-usage pattern?)



HardyFullDiskHandling (last edited 2008-08-06 16:31:55 by localhost)