Skip to content

tutorial-shell

Repo box/fedora
Base fedora

The teaching box behind opencharly.ai’s quickstart — a minimal, real dev shell Composes 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). The INIT itself is deliberately absent from the list: declaring a service is what selects an init, so charly adds that init’s own candy to the composition automatically and target-aware — supervisord for this container image, nothing at all for a machine venue, which already has systemd. 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/charly/candy/ripgrep:v2026.201.0706
  • @github.com/opencharly/charly/candy/sshd:v2026.201.0706