{"id":32159393,"url":"https://github.com/opensuse/catatonit","last_synced_at":"2026-02-18T22:01:45.671Z","repository":{"id":31120978,"uuid":"126943219","full_name":"openSUSE/catatonit","owner":"openSUSE","description":"A container init that is so simple it's effectively brain-dead.","archived":false,"fork":false,"pushed_at":"2024-12-14T16:09:09.000Z","size":113,"stargazers_count":250,"open_issues_count":7,"forks_count":21,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-12-10T15:48:55.858Z","etag":null,"topics":["containers","docker"],"latest_commit_sha":null,"homepage":null,"language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/openSUSE.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-03-27T07:02:37.000Z","updated_at":"2025-12-09T04:39:16.000Z","dependencies_parsed_at":"2024-11-01T07:31:15.545Z","dependency_job_id":null,"html_url":"https://github.com/openSUSE/catatonit","commit_stats":{"total_commits":53,"total_committers":10,"mean_commits":5.3,"dds":0.6037735849056604,"last_synced_commit":"663ad1670689143f65af3a288f90cecb7feed54f"},"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/openSUSE/catatonit","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openSUSE%2Fcatatonit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openSUSE%2Fcatatonit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openSUSE%2Fcatatonit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openSUSE%2Fcatatonit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/openSUSE","download_url":"https://codeload.github.com/openSUSE/catatonit/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openSUSE%2Fcatatonit/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29596329,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-18T20:59:56.587Z","status":"ssl_error","status_checked_at":"2026-02-18T20:58:41.434Z","response_time":162,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["containers","docker"],"created_at":"2025-10-21T13:02:34.230Z","updated_at":"2026-02-18T22:01:45.666Z","avatar_url":"https://github.com/openSUSE.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"## catatonit ##\n\n[![Build Status](https://github.com/openSUSE/catatonit/actions/workflows/ci.yml/badge.svg)](https://github.com/openSUSE/catatonit/actions/workflows/ci.yml)\n\nA container init that is so simple it's effectively brain-dead. This is a\nrewrite of [initrs][initrs] in C, because we found that it is not possible to\nstatically compile Rust binaries without using musl. That was, in turn, a\nreimplementation of other container inits like `tini` and `dumb-init`.\n\nThe reason for re-implementing `docker-init` is because it appears as though\nall of the other implementations do not handle signals as correctly as they\nshould. In particular, they all appear to make use of `sigwait(2)` (`tini` does\na `sigtimedwait(2)` for an interval and then will do a `waitpid(2)` even if it\ndidn't detect a `SIGCHLD`). `catatonit` uses `signalfd(2)`, which [has its own\nwarts][signalfd-broken], but the improvements over `sigwait(2)` are significant\nin terms of stability. Ideally we would just write a patch for the other\nprojects to use `signalfd(2)` rather than creating a new project, but after\nsome time spent looking at `tini` and `dumb-init` we felt that such patches\nwould be closer to full rewrites.\n\nIn addition, the purpose of `catatonit` is to only support the key usage by\n`docker-init` which is `/dev/init -- \u003cyour program\u003e`. With few exceptions, no\nother features will be added.\n\n[initrs]: https://github.com/cyphar/initrs\n[signalfd-broken]: https://ldpreload.com/blog/signalfd-is-useless\n\n### Usage ###\n\ncatatonit has identical usage to other basic `docker-init`'s -- you give it the\ncommand and list of arguments to that command.\n\nIf you install `catatonit` to `/usr/bin/docker-init`, `docker run --init` will\nuse `catatonit` as its container pid1. Alternatively, you can configure the\nDocker daemon to use `catatonit` without deleting any previously installed\n`/usr/bin/docker-init` by using `--init-path` (or adding an `init-path` setting\nin `/etc/docker/daemon.json`). Podman has similar options.\n\nCatatonit supports a very limit subset of features, in order to keep the code\nas simple as possible:\n\n* If catatonit is not pid1 (in other words, you are not in a PID namespace), it\n  will try to use the sub-reaper support in the kernel to act as a\n  \"pseudo-init\" for the process you requested.\n\n* You can pass `-g` if you want signals to be forwarded to the entire process\n  group of your spawned process (otherwise it's just forwarded to the process\n  spawned).\n\n* If you wish to use catatonit as a convenient pause container (do not spawn a\n  child process nor do any signal handling), you can pass `-P`.\n\nIf you want to include `catatonit` in your images, you can conveniently add it\nto your Dockerfile as an entrypoint:\n\n```dockerfile\n# Runs \"catatonit -- /my/amazing/script --with --args\"\nENTRYPOINT [\"catatonit\", \"--\"]\n\n# or if you use --rewrite or other cli flags\n# ENTRYPOINT [\"catatonit\", \"--rewrite\", \"2:3\", \"--\"]\n\nCMD [\"/my/amazing/script\", \"--with\", \"--args\"]\n```\n\n### Installation ###\n\ncatatonit uses autotools for building, so building is a fairly standard:\n\n```\n% ./autogen.sh\n% ./configure\n% make\n% sudo make install\n```\n\nNote that this install the `catatonit` binary to `/usr/bin/catatonit`. If you\nwant to use `docker run --init` you may need to symlink `/usr/bin/docker-init`\nto `catatonit` or configure Docker to use `catatonit`.\n\n### License ###\n\ncatatonit is licensed under the GNU General Public License version 2 or later.\n\n```\ncatatonit: a container init so simple it's effectively brain-dead\nCopyright (C) 2018-2023 SUSE LLC\n\nThis program is free software; you can redistribute it and/or modify\nit under the terms of the GNU General Public License as published by\nthe Free Software Foundation, either version 2 of the License, or\n(at your option) any later version.\n\nThis program is distributed in the hope that it will be useful,\nbut WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\nGNU General Public License for more details.\n\nYou should have received a copy of the GNU General Public License\nalong with this program.  If not, see \u003chttps://www.gnu.org/licenses/\u003e.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopensuse%2Fcatatonit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopensuse%2Fcatatonit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopensuse%2Fcatatonit/lists"}