Clone this repo:
  1. cf3bbea Clarify namespace fd preservation comment. by Jorge Lucangeli Obes · 4 weeks ago master
  2. 2337f80 Preserve namespace file descriptors. by Jorge Lucangeli Obes · 5 weeks ago
  3. 52f6ada make die messages slightly different by Mike Frysinger · 8 weeks ago crosvm-master android-o-mr1-iot-release-1.0.14
  4. 64cf3cb Fix RO-remount logic for bindmounts by Kevin Hamacher · 2 months ago linux-v10
  5. e4c6965 syscall_filter: fix multiline parsing with more than one line by Mike Frysinger · 8 weeks ago


The Minijail homepage and main repo is

There might be other copies floating around, but this is the official one!

What is it?

Minijail is a sandboxing and containment tool used in Chrome OS and Android. It provides an executable that can be used to launch and sandbox other programs, and a library that can be used by code to sandbox itself.

Getting the code

You're one git clone away from happiness.

$ git clone
$ cd minijail

Releases are tagged as linux-vXX:


See the document for more details.

Release process

See the document for more details.


We've got a couple of contact points.

Talks and presentations

The following talk serves as a good introduction to Minijail and how it can be used.

Video, slides.

Example usage

The Chromium OS project has a comprehensive sandboxing document that is largely based on Minijail.

After you play with the simple examples below, you should check that out.

Change root to any user

# id
uid=0(root) gid=0(root) groups=0(root),128(pkcs11)
# minijail0 -u jorgelo -g 5000 /usr/bin/id
uid=72178(jorgelo) gid=5000(eng) groups=5000(eng)

Drop root while keeping some capabilities

# minijail0 -u jorgelo -c 3000 -- /bin/cat /proc/self/status
Name: cat
CapInh: 0000000000003000
CapPrm: 0000000000003000
CapEff: 0000000000003000
CapBnd: 0000000000003000