tini/README.md

Tini - A tiny but valid init for containers

Tini is the simplest init you could think of.

All Tini does is spawn a single child (Tini is meant to be run in a container), and wait for it to exit all the while reaping zombies and performing signal forwarding.

Using Tini

Add Tini to your container, and make it executable.

Tini is a very small file (in the 10KB range), and all it depends on is libc.

Once you've added Tini, use it like so:

 tini -- your_program and its args

Note that you can skip the -- above if your program only accepts positional arguments, but it's best to get used to using it.

If you try to use positional arguments with Tini without using --, you'll get an error similar to:

./tini: invalid option -- 'c'

Understanding Tini

After spawning your process, Tini will wait for signals and forward those to the child process (except for SIGCHLD and SIGKILL, of course).

Besides, Tini will reap potential zombie processes every second.

Debugging

If something isn't working just like you expect, consider increasing the verbosity level (up to 4):

tini -v    -- bash -c 'exit 1'
tini -vv   -- true
tini -vvv  -- pwd
tini -vvvv -- ls