Are you happy with your logging solution? Would you help us out by taking a 30-second survey? Click here


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

Subscribe to updates I use binctr

Statistics on binctr

Number of watchers on Github 958
Number of open issues 0
Main language Go
Average time to merge a PR 2 days
Open pull requests 0+
Closed pull requests 1+
Last commit over 2 years ago
Repo Created over 3 years ago
Repo Last Updated over 1 year ago
Size 5.97 MB
Homepage https://blog.jess...
Organization / Authorjessfraz
Page Updated
Do you use binctr? Leave a review!
View binctr activity
View on github
Fresh, new opensource launches 🚀🚀🚀
Trendy new open source projects in your inbox! View examples

Subscribe to our mailing list

Evaluating binctr for your project? Score Explanation
Commits Score (?)
Issues & PR Score (?)


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:

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


You may have noticed you can't file an issue. That's because this is using a crazy person's (aka my) fork of libcontainer and until I get the patches into upstream there's no way in hell I'm fielding issues from whoever is crazy enough to try this.

If you are interested, I have started a thread on the mailing list with my proposed steps to make this a reality. Note, adding a +1 is not of any value to anyone though.

Nginx running with my user jessie.



This uses the new Golang vendoring so you need go 1.6 or GO15VENDOREXPERIMENT=1 in your env.

You will also 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.

$ make static
Static container created at: ./bin/alpine
Run with ./bin/alpine

# building a different base image
$ make static IMAGE=busybox
Static container created at: ./bin/busybox
Run with ./bin/busybox


$ ./alpine
$ ./busybox --read-only

Running with custom commands & args

# let's make an small web server binary
$ make static
Static container created at: ./bin/hello
Run with ./bin/hello

$ ./bin/hello /hello
2016/04/18 04:59:25 Starting server on port:  8080

# But we have no networking! How can we reach it! Don't worry we can fix this
# Let's install my super cool binary for setting up networking in a container
$ go get

# now we can add this as a prestart hook
$ ./bin/hello --hook prestart:netns /hello
2016/04/18 04:59:25 Starting server on port:  8080

# let's get the ip file
$ cat .ip

# we can curl it
$ curl -sSL $(cat .ip):8080
Hello World!



$ ./bin/alpine -h
 _     _            _
| |__ (_)_ __   ___| |_ _ __
| '_ \| | '_ \ / __| __| '__|
| |_) | | | | | (__| |_| |
|_.__/|_|_| |_|\___|\__|_|

 Fully static, self-contained container including the rootfs
 that can be run by an unprivileged user.

 Embedded Image: alpine - sha256:70c557e50ed630deed07cbb0dc4d28aa0f2a485cf7af124cc48f06bce83f784b
 Version: 0.1.0
 GitCommit: 13fcd27-dirty

  -D    run in debug mode
  -console string
        the pty slave path for use with the container
  -d    detach from the container's process
  -hook value
        Hooks to prefill into spec file. (ex. --hook prestart:netns) (default [])
  -id string
        container ID (default "nginx")
  -pid-file string
        specify the file to write the process id to
        make container filesystem readonly
  -root string
        root directory of container state, should be tmpfs (default "/run/binctr")
  -t    allocate a tty for the container (default true)
  -v    print version and exit (shorthand)
        print version and exit

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 :)


  • cgroups: coming soon
binctr list of languages used
Other projects in Go