# p8952/bocker

Docker implemented in around 100 lines of bash

Repository: https://github.com/p8952/bocker
Canonical: https://ross.abutalabs.com/products/bocker
Homepage: https://www.p8952.info/
Language: Shell
License: GPL-3.0
License Family: copyleft
Last push: 2017-12-09T14:16:38+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 4068, "days_push": 3189, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 12668, forks 751 (observed 2026-08-28T04:10:59.528853+00:00)

## What it is
Bocker is a minimal reimplementation of Docker in roughly 100 lines of bash, using Linux namespaces, cgroups, btrfs, and iptables to pull images and run isolated containers. It is primarily an educational demonstration of how container runtimes work under the hood.

## Use cases
- understand how docker works internally
- learn linux namespaces and cgroups
- run containers without installing docker
- teach container fundamentals
- minimal container runtime in bash
- study container isolation primitives

## When to choose
- you want to read a tiny, readable codebase to learn container internals
- you need a toy container runtime for a VM or lab environment
- you're teaching or demoing how namespaces, cgroups, and network bridges enable containers

## When to avoid
- you need a production container runtime - use Docker, Podman, or containerd
- you need full Docker feature coverage like volumes, networking modes, or compose
- you can't dedicate a VM or btrfs setup, since bocker runs as root and modifies network/firewall config

## Facets
- artifact type: cli-tool
- maturity: maintenance
- function: container-runtime, developer-tools, cli
- domain: developer-tools, operating-systems
- platform: cli
- tags: docker-clone, bash, educational, namespaces, cgroups, minimal-implementation, containers, devops, linux

## Member repositories
- p8952/bocker (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:59.528853+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:13:53.089328+00:00, confidence not recorded.
  - readme: https://github.com/p8952/bocker (fetched 2026-08-28T04:10:59.528853+00:00, sha e81fd63a5a47)
- Data as of 2026-08-30T08:39:29.467469+00:00.
