rsync to maintain synchronization between a tmpfs copy and media-bound backup of the browser profile(s). Additionally, psd features several crash recovery features.(psd) is a tiny pseudo-daemon designed to manage browser profile(s) in tmpfs and to periodically sync back to the physical disc (HDD/SSD). This is accomplished by an innovative use of
The design goals and benefits of psd are:
- Transparent user experience
- Reduced wear to physical drives
Since the profile(s), browser cache, etc. are relocated into tmpfs (RAM disk), the corresponding I/O associated with using the browser is also redirected from the physical drive to RAM, thus reducing wear to the physical drive and also greatly improving browser speed and responsiveness.
- Some browsers such as Chrome/Chromium, Firefox (since v21) and Midori actually keep their cache directories separately from their profile directory. It is not within the scope of profile-sync-daemon to modify this behavior; users are encouraged to refer to the Chromium tweaks#Cache in tmpfs section for Chromium and to the Firefox on RAM article for several workarounds.
- Occasionally, updates/changes are made to the default configuration file
/usr/share/psd/psd.confupstream. The user copy
$XDG_CONFIG_HOME/psd/psd.confwill need to be diffed against it. On Arch Linux, pacman should notify the user to do this.
- psd can slow down login, as that is when it copies your browser cache to RAM.
Install the package.
When first run, psd will create
$XDG_CONFIG_HOME/psd/psd.conf (referred to hereafter as the configuration file) which contains all settings.
psd.servicehas been restarted.
$ psd First time running psd so please edit
$XDG_CONFIG_HOME/psd/psd.confto your liking and run again.
- Optionally enable the use of overlayfs to improve sync speed and to use a smaller memory footprint. Do this in the
USE_OVERLAYFSvariable. The user will require sudo rights to
/usr/bin/psd-overlay-helperto use this option and the kernel must support overlayfs version 22 or higher. See #Overlayfs mode for additional details.
- Optionally define which browsers are to be managed in the
BROWSERSarray. If none are defined, the default is all detected browsers.
- Optionally disable the use of crash-recovery snapshots (not recommended). Do this in the
- Optionally define the number of crash-recovery snapshots to keep. Do this in the
Example: Let us say that Chromium, Opera and Midori are installed but only Chromium and Opera are to be sync'ed to tmpfs since the user keeps Midori as a backup browser and it is seldom used:
# List browsers separated by spaces to include in the sync. Useful if you do not # wish to have all possible browser profiles sync'ed which is the default if # this variable is left commented. # # Possible values: # chromium # chromium-dev # conkeror.mozdev.org # epiphany # firefox # firefox-trunk # google-chrome # google-chrome-beta # google-chrome-unstable # heftig-aurora # icecat # inox # luakit # midori # opera # opera-beta # opera-developer # opera-legacy # otter-browser # qupzilla # qutebrowser # palemoon # rekonq # seamonkey # surf # vivaldi # vivaldi-snapshot # BROWSERS=(chromium opera)
Currently, the following browsers are auto-detected and managed:
- Firefox (all flavors including stable, beta, and nightly)
- heftig's version of Aurora: An Arch Linux-only browser
- Otter Browser
- AUR / AUR
Start and stop psd
With the release of the version 6.x series of psd, the only init system that is officially supported is systemd. Psd ships with a systemd user service to start or stop it (
psd.service). Additionally, a provided resync-timer will run an hourly resync from tmpfs back to the disk. The resync-timer is started automatically with
psd.service so there is no need to manually start the timer.
For users unfamiliar with systemd user mode, see Systemd/User.
Preview (parse) mode
The 'parse' option can be called to show users exactly what psd will do/is doing based on
$XDG_CONFIG_HOME/psd/psd.conf as well printout useful information such as profile size, paths, and if any recovery snapshots have been created.
$ psd p Profile-sync-daemon v6.44 Systemd service: active resync-timer: active sync on sleep: enabled use overlayfs: enabled Psd will manage the following per /home/facade/.config/psd/psd.conf settings: browser/psname: chromium/chromium owner/group id: facade/100 sync target: /home/facade/.config/chromium tmpfs dir: /run/user/1000/facade-chromium profile size: 93M overlayfs size: 39M recovery dirs: 2 <- delete with the c option dir path/size: /home/facade/.config/chromium-backup-crashrecovery-20150117_171359 (92M) dir path/size: /home/facade/.config/chromium-backup-crashrecovery-20150119_112204 (93M) browser/psname: firefox/firefox owner/group id: facade/100 sync target: /mnt/data/docs/facade/mozilla/firefox/f8cv8bfu.default tmpfs dir: /run/user/1000/facade-firefox-f8cv8bfu.default profile size: 145M overlayfs size: 13M recovery dirs: none
As shown in the output and as stated above, if no specific browser or subset of browsers are defined in the BROWSERS array, psd will sync ALL supported profiles that it finds for the given user(s).
Tip and Tricks
Sync at more frequent intervals (optional)
The package provided re-sync timer triggers once per hour. Users may optionally redefine this behavior simply by extending the systemd unit. The example below changes the timer to sync once every ten minutes:
[Unit] Description=Timer for Profile-sync-daemon [Timer] OnUnitActiveSec= OnUnitActiveSec=10m
Seefor additional options.
Overlayfs is a simple union file-system mainlined in the Linux kernel version 3.18.0. Starting with psd version 5.54, overlayfs can be used to reduce the memory footprint of psd's tmpfs space and to speed up sync and unsync operations. The magic is in how the overlay mount only writes out data that has changed rather than the entire profile. The same recovery features psd uses in its default mode are also active when running in overlayfs mode. Overlayfs mode is enabled by uncommenting the
USE_OVERLAYFS="yes" line in
$XDG_CONFIG_HOME/psd/psd.conf followed by a restart of the daemon.
Since version 6.05 of psd, users wanting to take advantage of this mode MUST have sudo rights (without password prompt) to
/usr/bin/psd-overlay-helper or global sudo rights. The following line in
/etc/sudoers will supply a user with these rights (replace "user" with your actual username). Add it using visudo:
user ALL=(ALL) NOPASSWD: /usr/bin/psd-overlay-helper
See the example in the PREVIEW MODE section above which shows a system using overlayfs to illustrate the memory savings that can be achieved. Note the "overlayfs size" report compared to the total "profile size" report for each profile. Be aware that these numbers will change depending on how much data is written to the profile, but in common use cases the overlayfs size will always be less than the profile size.
The way overlayfs works is to mount a read-only base copy (browser-back-ovfs) of the profile, and manage the new data on top of that. In order to avoid resyncing to the read-only file system, a copy is used instead. So using overlayfs is a trade off: faster initial sync times and less memory usage vs. disk space in the home dir.
Allocate more memory to accommodate profiles in /run/user/xxxx
The standard way of controlling the size of
/run/user is the RuntimeDirectorySize directive in
/etc/systemd/logind.conf (see for more). By default, 10% of physical memory is used but one can increase it safely. Remember that tmpfs only consumes what is actually used; the number specified here is just a maximum allowed.
Odds are the "last good" backup of your browser profiles is just fine still sitting happily on your filesystem. Upon restarting
psd (on a reboot for example), a check is performed to see if the symlink to the tmpfs copy of your profile is invalid. If it is invalid, psd will snapshot the "last good" backup before it rotates it back into place. This is more for a sanity check that psd did no harm and that any data loss was a function of something else.
USE_BACKUPSvariable to 'no' in
You will find the snapshot in the same directory as the browser profile and it will contain a date-time-stamp that corresponds to the time at which the recovery took place. For example, chromium will be
~/.config/chromium-backup-crashrecovery-20130912_153310 -- of course, the date_time suffix will be different for you.
To restore your snapshots:
- Confirm that there is no symlink to the tmpfs browser profile directory. If there is, psd did not stop correctly for other reasons.
- Move the "bad" copy of the profile to a backup (do not blindly delete anything).
- Copy the snapshot directory to the name that browser expects.
Example using Chromium:
mv ~/.config/chromium ~/.config/chromium-bad cp -a ~/.config/chromium-backup-crashrecovery-20130912_153310 ~/.config/chromium
At this point you can launch chromium which will use the backup snapshot you just copied into place. If all is well, close the browser and restart psd. You may safely delete
~/.config/chromium-backup-crashrecovery-20130912_153310 at this point.
Clean all the snapshot with the clean mode
The clean mode will delete ALL recovery snapshots that have accumulated. Run this only if you are sure that you want to delete them.
$ psd c Profile-sync-daemon v6.03 on Arch Linux. Deleting 2 crashrecovery dirs for profile /home/facade/.config/chromium /home/facade/.config/chromium-backup-crashrecovery-20150117_171359 /home/facade/.config/chromium-backup-crashrecovery-20150119_112204
Post in the discussion thread with comments or concerns.