Documentation

Name: podbox
Author: Bethuel Kipsang

User Guides

Doc	What it covers
Quick Start	Install, create a container, essential workflows
Configuration Reference	All TOML keys, defaults, and examples
Base packages	Tools, shells, locales preinstalled in custom builds
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
Home Setup	Dotfiles and provisioning steps inside the container home

Reference

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

Quick Reference

bash

1podbox use <name>                # set active context
2podbox profile list              # list available profiles
3podbox profile show <name>       # show profile TOML
4podbox create <profile>          # create + build + enable + start
5podbox enter <name>              # open a shell
6podbox exec -- <cmd>             # run a command
7podbox run <app>                 # run a GUI app
8podbox stats                     # show resource usage
9podbox doctor --fix              # fix common issues
10podbox export app <name>         # add to host launcher
11podbox diff                      # check installed packages vs config
12podbox remove --all              # full cleanup

Most commands accept an optional <name> — defaults to the active context. See cli.md for name resolution, exit codes, and JSON output.