summaryrefslogtreecommitdiffstats
path: root/system/tini/README
diff options
context:
space:
mode:
Diffstat (limited to 'system/tini/README')
-rw-r--r--system/tini/README15
1 files changed, 15 insertions, 0 deletions
diff --git a/system/tini/README b/system/tini/README
new file mode 100644
index 0000000000..b29f69a2bc
--- /dev/null
+++ b/system/tini/README
@@ -0,0 +1,15 @@
+Tini is a tiny but valid init for containers. 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 has several benefits:
+
+- It protects you from software that accidentally creates zombie
+ processes, which can (over time!) starve your entire system for PIDs
+ (and make it unusable).
+- It ensures that the default signal handlers work for the software you
+ run in your Docker image. For example, with Tini, SIGTERM properly
+ terminates your process even if you didn't explicitly install a signal
+ handler for it.
+- It does so completely transparently! Docker images that work without
+ Tini will work with Tini without any changes.