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

#30 in Unix APIs

Download history 33/week @ 2018-10-21 4/week @ 2018-10-28 128/week @ 2018-11-04 117/week @ 2018-11-11 62/week @ 2018-11-18 32/week @ 2018-11-25 170/week @ 2018-12-02 38/week @ 2018-12-09 43/week @ 2018-12-16 64/week @ 2018-12-23 32/week @ 2018-12-30 1/week @ 2019-01-06 33/week @ 2019-01-13

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.


~184K SLoC