Skip to content

Latest commit

 

History

History
43 lines (29 loc) · 1.59 KB

distro-compat.md

File metadata and controls

43 lines (29 loc) · 1.59 KB
Raw

Sysbox Distro Compatibility

Contents

Supported Linux Distros

Sysbox relies on functionality that is currently only present in Ubuntu Linux. As a result Ubuntu is the only distro supported at this time. We are working on adding support for more distros.

Ubuntu Support

Sysbox requires recent Ubuntu versions:

  • Ubuntu 20.04 "Focal Fossa"
  • Ubuntu 19.10 "Eoan Ermine"
  • Ubuntu 18.04 "Bionic Beaver" (point releases older than 18.04.4 require kernel upgrade)

These versions carry some new Linux kernel features that Sysbox relies on to create the system containers.

NOTE: If you have a relatively old Ubuntu 18.04 release (e.g. 18.04.3), you need to upgrade the kernel to >= 5.0. We recommend using Ubuntu's LTS-enablement package to do the upgrade as follows:

$ sudo apt-get update && sudo apt install --install-recommends linux-generic-hwe-18.04 -y

Using Sysbox On Kernels Without the Shiftfs Module

Recent Ubuntu kernels carry a module called shiftfs that Sysbox uses as part of its container isolation strategy.

With shiftfs, Sysbox can create containers that use the user-namespace for strong isolation without requiring the higher level container manager to do this explicitly (e.g., without enabling userns-remap mode in Docker).

However, some Ubuntu cloud images do not carry the module. In this case, Sysbox requires that Docker be configured in userns-remap mode.