Skip to content

tutorial-shell

Repo box/fedora
Base fedora

The teaching box behind opencharly.ai’s quickstart — a minimal, real dev shell. Composes the init candy plus two candies on the bare Fedora base, each chosen to demonstrate one distinct idea a newcomer has to learn: ripgrep is a pure TOOL layer (packages and probes, no service); sshd is a SERVICE layer, and the canonical init-polymorphism example (one service: list carrying both a use_packaged: systemd form and a custom exec: supervisord form, so the same candy runs under either init). supervisord is the init candy: declaring a service is what selects an init, and composing that init’s candy explicitly makes the assembled /etc/supervisord.conf deterministic — this container image needs the supervisord candy, while a machine venue would compose systemd instead. If the acting init’s candy is not in the scanned set charly warns and injects nothing. Kept deliberately small: every line of this box is quoted on the documentation site, so it must stay readable end to end. The box’s own plan asserts exactly one thing — the WIRING composition produces, namely that the service candy became a supervisord program. Co-residence is already proven by the composed candies’ own plans running against this same image, so the box does not restate it.

This box composes:

  • @github.com/opencharly/layer-supervisord:v2026.240.0121
  • @github.com/opencharly/layer-ripgrep:v2026.235.1653
  • @github.com/opencharly/pod-sshd:v2026.239.1637