Project: Sysbox (Runtime / Container Runtime)
File: systemd.md

System containers can act as virtual host environments running multiple services. As such, including a process manager inside the container such as Systemd is useful (e.g., to start and stop services in the appropriate sequence, perform zombie process reaping, etc.) Moreover, many applications rely on Systemd in order to function properly (in particular legacy (non-cloud) applications, but also cloud-native software such as Kubernetes). If you want to run these in a container, Systemd must be present in the container. Starting with release v0.1.2, Sysbox has preliminary support for running Systemd inside a system container, meaning that Systemd works but there are still some minor issues that need resolution. With Sysbox, you can run Systemd-in-Docker easily and securely, without the need to create complex Docker run commands or specialized image entrypoints, and without resorting to privileged Docker containers. Simply launch a system container image that has Systemd as its entry point and Sysbox will ensure the system container is setup to run Systemd without problems. You can find examples of system container images that come with Systemd in the repository. The Nestybox and have a number of these images too. The Sysbox Quick Start Guide has a on how to use them. Of course, the container image will also need to have the systemd service units that you need. These service units are typically added to the image during the image build process. For example, the for the `nestybox/ubuntu-bionic-systemd-docker` image includes Docker's systemd service unit by simply installing Docker in the container. As a result, when you launch that container, Systemd automatically starts Docker. The great majority of systemd services work well inside system container deployed with Sysbox. However, the following services are known not to work: This service pulls audit logs from the kernel and enters them into the systemd journal. It fails inside the container because it does not have permission to access the kernel's audit log. Note that this log is currently a system-wide log, so accessing inside the container may not be appropriate anyway. This services monitors device events from the kernel's udev subsystem. It fails inside the container because it does not have the required permissions. This service is not needed inside a system container, as devices exposed in the container are setup when the container is started and are immutable (i.e., hot-plug is not supported). This service waits for all network devices to be online. For some yet-to-be-determined reason, this service is failing inside a system container. Note that the service is usually not required, given that the container's network interfaces are virtual and are thus normally up and running when the container starts. To disable systemd services inside a container, the best approach is to modify the Dockerfile for the container and add a line such as: ``` RUN systemctl mask systemd-journald-audit.socket systemd-udev-trigger.service systemd-firstboot.service systemd-networkd-wait-online.service ``` See this . We recommend disabling the unsupported systemd services (see prior section), as well as other services which don't make sense to have in the container for your use case. This results in faster container startup time and possibly better performance. Systemd is great but may be a bit too heavy for your use case. In that case you can use lighter-weight process managers such as . You can find examples in the repository. The has a number of system container images that come with Supervisord inside. The Sysbox Quick Start Guide has a on how to use them.