31 releases (8 breaking)

0.18.4 Aug 10, 2018
0.18.2 Jul 7, 2018
0.15.5 Mar 20, 2018
0.13.2 Nov 30, 2017

#21 in Unix APIs

Download history 391/week @ 2018-07-01 22/week @ 2018-07-08 52/week @ 2018-07-15 102/week @ 2018-07-22 81/week @ 2018-07-29 175/week @ 2018-08-05 102/week @ 2018-08-12 32/week @ 2018-08-19 60/week @ 2018-08-26 22/week @ 2018-09-02 28/week @ 2018-09-09 31/week @ 2018-09-16 6/week @ 2018-09-23

544 downloads per month


7.5K SLoC



Lithos is a process supervisor and containerizer for running services. Lithos is not intended to be system init. But rather tries to be a base tool to build container orchestration.


  • use linux namespaces and cgroups for containerization
  • immediate restart of failing processes (with rate limit of course)
  • in-place upgrade of lithos without touching child processes
  • written in Rust so memory-safe and has zero runtime dependencies

It's designed to have absolutely minimal required functionality. In particular it doesn't include:

  • an image downloader (rsync is super-cool) or builder (use any tool)
  • any network API

Running Examples

Testing it in vagrant::

vagrant up && vagrant ssh

In vagrant shell::

$ ./example_configs.sh
$ sudo lithos_tree

If you want to change containers, sources or configs of this test vagrant deployment just rerun ./example_configs.sh.

(Note: in this test deployment lithos doesn't properly reload configs, because images does not version properly. Just restart lithos_tree to apply the changes)


Licensed under either of


Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.


~180K SLoC