boxkit is a set of GitHub actions and skeleton files to build toolbox and distrobox images. Basically, clone this repo, make the changes you want, and then build what you need. Some examples include:
- DaVinci Box - Container for DaVinci Resolve installation and runtime dependencies on Linux
- obs-studio-portable - OCI container image of OBS Studio that bundles a curated collection of 3rd party plugins
- bazzite-arch - A ready-to-game Arch Linux based OCI designed for use exclusively in distrobox
You can use whatever distribution you want with boxkit, this is the initial example (here are more):
If you use distrobox:
distrobox create -i ghcr.io/ublue-os/boxkit -n boxkit
distrobox enter boxkit
If you use toolbx:
toolbox create -i ghcr.io/ublue-os/boxkit -c boxkit
toolbox enter boxkit
Use chezmoi to pull down your dotfiles and set up git sync.
Fork and add programs to this this image - over time you'll end up with the perfect CLI for you. Keeping it as a pet works, though the author recommends leaving all your config in git and routinely pulling a new image.
The user experience is much nicer if you set use Ptyxis and is the intended experience.
These images are signed with sisgstore's cosign. You can verify the signature by downloading the cosign.pub key from this repo and running the following command:
cosign verify --key cosign.pub ghcr.io/ublue-os/boxkit
If you're forking this repo you should read the docs on keeping secrets in github. You need to generate a new keypair with cosign. The public key can be in your public repo (your users need it to check the signatures), and you can paste the private key in Settings -> Secrets -> Actions.
Of course you can make this however you want, but start with the Toolbx Community images. These are a set of mostly-stock images with packages needed to run as a toolbox/distrobox already installed.
Try to derive your blingbox from those base images so we can all help maintain them over time, you can't have bling without good stock!
Tag your image with boxkit to share with others!
