Running rkt with the fly stage1

The fly stage1 is an alternative stage1 that runs a single-application ACI with only chroot-isolation.


The motivation of the fly feature is to add the ability to run applications with full privileges on the host but still benefit from the image management and discovery from rkt. The Kubernetes kubelet is one candidate for rkt fly.

How does it work?

In comparison to the default stage1, there is no process manager involved in the stage1. This a visual illustration for the differences in the process tree between the default and the fly stage1:


host OS
  └─ rkt
    └─ systemd-nspawn
      └─ systemd
        └─ chroot
          └─ user-app1


host OS
  └─ rkt
    └─ chroot
      └─ user-app1

The rkt application sets up bind mounts for /dev, /proc, /sys, and the user-provided volumes. In addition to the bind mounts, an additional tmpfs mount is done at /tmp. After the mounts are set up, rkt chroots to the application's RootFS and finally executes the application.

Mount propagation modes

The fly stage1 makes use of Linux mount propagation modes. If a volume source path is a mountpoint on the host, this mountpoint is made recursively shared before the host path is mounted on the target path in the container. Hence, changes to the mounts inside the container will be propagated back to the host.

The bind mounts for /dev, /proc, and /sys are done automatically and are recursive, because their hierarchy contains mounts which also need to be available for the container to function properly. User-provided volumes are not mounted recursively. This is a safety measure to prevent system crashes when multiple containers are started that mount / into the container.

Getting started

You can either use stage1-fly.aci from the official release, or build rkt yourself with the right options:

$ ./ && ./configure --with-stage1-flavors=fly && make

For more details about configure parameters, see the configure script parameters documentation. This will build the rkt binary and the stage1-fly.aci in build-rkt-1.29.0+git/bin/.

Selecting stage1 at runtime

Here is a quick example of how to use a container with the official fly stage1:

# rkt run

If the image is not in the store, --stage1-name will perform discovery and fetch the image.

Notes on isolation and security

By design, the fly stage1 does not provide the same isolaton and security features as the default stage1.

Specifically, the following constraints are not available when using the fly stage1:

  • network namespace isolation
  • CPU isolators
  • Memory isolators
  • CAPABILITY bounding
  • SELinux

Providing additional isolation with systemd

When using systemd on the host it is possible to wrap rkt with a systemd unit file to provide additional isolation. For more information please consult the systemd manual. systemd.resource-control systemd.directives