GitHunt
BM

bmiklautz/lxcfs

FUSE filesystem for LXC

lxcfs

Introduction

FUSE filesystem for LXC, offering the following features:

  • a cgroupfs compatible view for unprivileged containers
  • a set of cgroup-aware files:
    • cpuinfo
    • meminfo
    • stat
    • uptime

In other words, it will provide an emulated /proc and /sys/fs/cgroup folder for the containers.

Usage

The recommended command to run lxcfs is:

sudo mkdir -p /var/lib/lxcfs
sudo lxcfs -s -f -o allow_other /var/lib/lxcfs
  • -s is required to turn off multi-threading as libnih-dbus isn't thread safe.
  • -f is to keep lxcfs running in the foreground
  • -o allow_other is required to have non-root user be able to access the filesystem
  • -d can also be passed in order to debug lxcfs

In order to use lxcfs with systemd-based containers, you can either use
LXC 1.1 in which case it should work automatically, or otherwise, copy
the lxc.mount.hook file (once built) from this tree to
/usr/share/lxc/hooks/lxcfs, make sure it is executable, then add the
following two lines to your container configuration:

lxc.autodev = 1
lxc.kmsg = 0
lxc.include = /usr/share/lxcfs/00-lxc.conf

Languages

C93.7%Shell6.3%

Contributors

Apache License 2.0
Created October 28, 2015
Updated October 28, 2015