A wrapper script for the zram kernel module with interactive and init support
(C) Martin Väth (martin at mvath.de).
Many thanks to all people in the
AUTHORS file for contributing.
The license of this package is the GNU Public License GPL-2.
This is a small helper script to setup a zram device as swap or as a ramdisk. Also a zsh completion file and openrc and systemd init-scripts are provided.
zramctl (from >=util-linux-2.26) is available,
this is used by default.
Currently, this is not a dependency: a manual method is provided as a fallback.
The latter might be removed in a future release of this script.
If you want to use one of the options
-Z to pass generic args,
push.sh (v2.0 or newer) in your
To install this script, just copy the content of
sbin into root's
To obtain support for zsh completion, copy the content of
For openrc support, the content of openrc should go into
For systemd support, the content of
systemd/system should go into a
systemd unit directory (
pkg-config --variable=systemdsystemunitdir systemd,
/usr/lib/systemd/system) and be modified
and enabled with
systemctl enable ... for the desired setting.
(Or install locally, e.g. directly into
For systemd and optionally also for openrc the content of
should go into
/etc/modprobe.d and be modified
LZ4 compression with zram your kernel needs to be compiled with
a corresponding options. Depending on your kernel version this might be
CONFIG_ZRAM_LZ4_COMPRESS=y(for older kernels)
CONFIG_CRYPTO_LZ4=y(for recent kernels)
Instructions for specific distributions
To install this script, you should use:
make install # for installation to /usr/local make PREFIX=/usr install # /usr instead of /usr/local
There is an ebuild in the main gentoo tree (usually an older version) and in the mv overlay (current version).
A zram-init package is available.
To install on Arch based distribution: install
zram-init-git from AUR
Once installed, configure:
sudo cp /usr/lib/systemd/system/zram* /etc/systemd/system/
Lets make your configuration tweaks in
/etc/modprobe.d/zram.conf /etc/systemd/system/zram_swap.service /etc/systemd/system/zram_tmp.service /etc/systemd/system/zram_var_tmp.service
sudo systemctl start zram_swap.service sudo systemctl start zram_tmp.service sudo systemctl start zram_var_tmp.service
and finaly enable
sudo systemctl enable zram_swap.service sudo systemctl enable zram_tmp.service sudo systemctl enable zram_var_tmp.service
Optional remove any swap references in