Fully static, unprivileged, self-contained, containers as executable binaries.

Clone this repo:


  1. 66e3930 update travis by Jess Frazelle · 1 year, 8 months ago master
  2. e08afe0 Update ToC for README.md by toc-me[bot] · 2 years, 1 month ago
  3. d3b6257 toc by Jess Frazelle · 2 years, 1 month ago
  4. db50a63 Fix golint import path (#10) by alexander zillion · 2 years, 3 months ago
  5. 6a99940 cheange order by Jess Frazelle · 2 years, 4 months ago


Build Status Go Report Card GoDoc

Create fully static, including rootfs embedded, binaries that pop you directly into a container. Can be run by an unprivileged user.

Check out the blog post: blog.jessfraz.com/post/getting-towards-real-sandbox-containers.

This is based off a crazy idea from @crosbymichael who first embedded an image in a binary :D

HISTORY: This project used to use a POC fork of libcontainer until @cyphar got rootless containers into upstream! Woohoo! Check out the original thread on the mailing list.

Table of Contents

Checking out this repo

$ git clone git@github.com:genuinetools/binctr.git


You will need libapparmor-dev and libseccomp-dev.

Most importantly you need userns in your kernel (CONFIG_USER_NS=y) or else this won't even work.

# building the alpine example
$ make alpine
Static container created at: ./alpine

# building the busybox example
$ make busybox
Static container created at: ./busybox

# building the cl-k8s example
$ make cl-k8s
Static container created at: ./cl-k8s


$ ./alpine
$ ./busybox
$ ./cl-k8s

Cool things

The binary spawned does NOT need to oversee the container process if you run in detached mode with a PID file. You can have it watched by the user mode systemd so that this binary is really just the launcher :)