tmpfs - ArchWiki

Jump to content

tmpfs is a temporary filesystem that resides in memory and/or swap partition(s). Mounting directories as tmpfs can be an effective way of speeding up accesses to their files, or to ensure that their contents are automatically cleared upon reboot.

Tip: Temporary files in tmpfs directories can be recreated at boot by using systemd-tmpfiles.

## Usage

Some directories where tmpfs(5) is commonly used are /tmp, /var/lock and /var/run. Do not use it on /var/tmp, because that directory is meant for temporary files that are preserved across reboots.

Arch uses a tmpfs `/run` directory, with `/var/run` and `/var/lock` simply existing as symlinks for compatibility. It is also used for `/tmp` by the default systemd setup and does not require an entry in fstab unless a specific configuration is needed.

glibc 2.2 and above expects tmpfs to be mounted at `/dev/shm` for POSIX shared memory. Mounting tmpfs at `/dev/shm` is handled automatically by systemd and manual configuration in fstab is not necessary.

Generally, tasks and programs that run frequent read/write operations can benefit from using a tmpfs directory. Some applications can even receive a substantial gain by offloading some (or all) of their data onto the shared memory. For example, relocating the Firefox profile into RAM shows a significant improvement in performance.

## Examples

Note: The actual memory/swap consumption depends on how much is used, as tmpfs partitions do not consume any memory until it is actually needed.

By default, a tmpfs partition has its maximum size set to half of the available RAM, however it is possible to overrule this value. To explicitly set a maximum size, in this example to override the default `/tmp` mount, use the `size` mount option:

    /etc/fstab

    tmpfs   /tmp         tmpfs   rw,nodev,nosuid,size=2G          0  0

To specify a more secure mounting, specify the following mount option:

    /etc/fstab

    tmpfs   /www/cache    tmpfs  rw,size=1G,nr_inodes=5k,noexec,nodev,nosuid,uid=user,gid=group,mode=1700 0 0

See the tmpfs(5) man page and Security#File systems for more information.

Reboot for the changes to take effect. Note that although it may be tempting to simply run `mount -a` to make the changes effective immediately, this will make any files currently residing in these directories inaccessible (this is especially problematic for running programs with lockfiles, for example). However, if all of them are empty, it should be safe to run `mount -a` instead of rebooting (or mount them individually).

After applying changes, verify that they took effect by looking at `/proc/mounts` and using `findmnt`:

    $ findmnt /tmp

    TARGET SOURCE FSTYPE OPTIONS
    /tmp   tmpfs  tmpfs  rw,nosuid,nodev,relatime

The tmpfs can also be temporarily resized without the need to reboot, for example when a large compile job needs to run soon. In this case, run:

    # mount -o remount,size=4G,noatime /tmp

## Disable automatic mount

Under systemd, `/tmp` is automatically mounted as a tmpfs, if it is not already a dedicated mountpoint (either tmpfs or on-disk) in `/etc/fstab`. To disable the automatic mount, mask the `tmp.mount` systemd unit.

Files will no longer be stored in a tmpfs, but on the block device instead. The `/tmp` contents will now be preserved between reboots, which might not be the desired behavior. To regain the previous behavior and clean the `/tmp` directory automatically when restarting, consider using tmpfiles.d(5):

    /etc/tmpfiles.d/tmp.conf

    # see tmpfiles.d(5)
    # always enable /tmp directory cleaning
    D! /tmp 1777 root root 0

    # remove files in /var/tmp older than 10 days
    D /var/tmp 1777 root root 10d

    # namespace mountpoints (PrivateTmp=yes) are excluded from removal
    x /tmp/systemd-private-*
    x /var/tmp/systemd-private-*
    X /tmp/systemd-private-*/tmp
    X /var/tmp/systemd-private-*/tmp

## Troubleshooting

### Opening symlinks in tmpfs as root fails

Considering `/tmp` is using tmpfs, change the current directory to `/tmp`, then create a file and create a symlink to that file in the same `/tmp` directory. Permission denied errors are to be expected when attempting to read the symlink due to `/tmp` having the sticky bit set.

This behavior can be controlled via `/proc/sys/fs/protected_symlinks` or simply via sysctl: `sysctl -w fs.protected_symlinks=0`. See Sysctl#Configuration to make this permanent.

Warning: Changing this behavior can lead to security issues!

## See also

- Linux kernel documentation

Category:

- File systems