| Doc | What it covers |
|---|---|
| Quick Start | Install, create a container, essential workflows |
| Configuration Reference | All TOML keys, defaults, and examples |
| Baked-in Base Packages | Auto-installed packages, locale, timezone, sudo |
| Desktop Integration | Exporting container apps and binaries to the host |
| Container Integration | How the guest daemon bridges notifications, URI opening, clipboard |
| D-Bus Proxy | Filtered D-Bus access via xdg-dbus-proxy |
| Doc | What it covers |
|---|---|
| Architecture Overview | How podbox works end-to-end |
| Quadlet Keys | Generated systemd unit files |
| Host-Guest Protocol | Wire format and message types |
| Exit Codes | Program exit code meanings |
| Doc | What it covers |
|---|---|
| Roadmap | Phase plans and scope |
| PLAN.md | Implementation plans |
podbox use <name> # set active context
podbox profile list # list available profiles
podbox profile show <name> # show profile TOML
podbox create <profile> # create + build + enable + start
podbox enter <name> # open a shell
podbox exec -- <cmd> # run a command
podbox run <app> # run a GUI app
podbox stats # show resource usage
podbox doctor --fix # fix common issues
podbox export app <name> # add to host launcher
podbox diff # check installed packages vs config
podbox remove --all # full cleanupMost commands accept an optional <name> — defaults to the active context.
See the README for the full command reference.