Automatically unburden $HOME from caches, etc. Useful for $HOME on SSDs, small disks or slow NFS homes. Can be triggered via an hook in /etc/X11/Xsession.d/.
Perl Makefile Shell
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
Xsession.d Use sane tmpfs-based defaults for $XDG_CACHE_HOME if ubhd is unconfig… May 2, 2016
bin Update copyright years and my e-mail address Aug 28, 2016
debian Update list of Git repositories Aug 28, 2016
docs Comment out GitHub Pages theme Aug 29, 2016
etc Don't set TARGETDIR in config by default but compute a sane default v… Jul 4, 2015
share also needs to source /etc/unburden-home-dir May 14, 2015
t t/version.t: Re-enable strictures; fix reason why they were disabled Aug 11, 2016
.bookignore Try to add Gitbook support Dec 11, 2015
.gitignore Update .gitignore wrt. unburden-home-dir-doc May 24, 2016
COPYING Make LICENSE a file and COPYING a symlink Oct 17, 2016
LICENSE Make LICENSE a file and COPYING a symlink Oct 17, 2016
Makefile Enable additional code coverage by Codecov Aug 28, 2016 Add GitPitch slides Aug 28, 2016
PITCHME.yaml Add GitPitch slides Aug 28, 2016 Add GitPitch slides Aug 28, 2016 Declare man page as appendix of the documentation Dec 11, 2015 Move TODO list into docs/. Jun 4, 2015
mkdocs.yml Switch to new mkdocs.yml syntax Dec 13, 2015

Unburden Your Home Directory

Travis CI Build Status Documentation Status Coverage by Coveralls Coverage by Codecov Gitbook Build Status GitPitch Slides

unburden-home-dir allows users to move cache files from browsers, etc. off their home directory, i.e. on a local harddisk or tmpfs and replace them with a symbolic link to the new location (e.g. on /tmp/ or /scratch/) upon login. Optionally the contents of the directories and files can be removed instead of moved.

This is helpful at least in the following cases:

  • The idea-giving case are big workstation setups where $HOME is on NFS and all those caches put an unnecessary burden (hence the name) on the file server since caching over NFS doesn't have the best performance and may clog the NFS server, too.

  • A similar case, but with different purpose is reducing I/O on mobile devices like laptops or netbooks to extend the battery life or reduce the wearing down of CF or SD cards, e.g. in single board computers like the Raspberry Pi or ALIX or APU boards: Moving browser caches etc. off the real disk into a tmpfs filesystem reduces the amount of disk I/O which reduces the power consumption of the disk.

  • Another type of use cases for unburden-home-dir is to reduce disk space usage, e.g. on devices with small disk space but a lot of RAM as seen often on boxes with flash disks or early netbooks, e.g. the first EeePC with 4GB disk space and 2GB RAM are not seldom. In this case you want to move off as many cache files, etc. as possible to some tmpfs filesystem, e.g. /tmp/.

  • It may also help to reduce the amount of needed backup disk space by keeping those files in places where they don't get backed up. In that case it's an alternative to keeping the blacklist in your backup software up-to-date.

  • Another pragmatic use case may be to stay — as an user — within a given disk quota. :-)

This project initially started as an Xsession hook. It now consists of a perl script which optionally can also be called from a provided Xsession hook.

The full documentation can be read online at ReadTheDocs, at Gitbook or downloaded as e-book at Gitbook.


Axel Beckert

unburden-home-dir initially has been developed for usage at Dept. of Physics, ETH Zurich.


unburden-home-dir is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program in the file COPYING. If not, see GNU's license web page.