lumi/aerbox
1
9
Fork
You've already forked aerbox
0
Distrobox/toolbx but using AerynOS
  • Rust 99.9%
  • Shell 0.1%
2026年06月16日 00:09:40 +02:00
crates refactor aerbox-login 2026年06月13日 21:09:10 +02:00
src use read_dir directly to list wayland and pipewire sockets 2026年06月13日 20:31:51 +02:00
templates update rust-dev template 2026年06月13日 19:21:09 +02:00
.gitignore add script to build host data dir 2026年06月09日 20:58:48 +02:00
build-host.sh add script to build host data dir 2026年06月09日 20:58:48 +02:00
Cargo.lock merge desktop crate into xdg crate 2026年06月13日 19:24:34 +02:00
Cargo.toml merge desktop crate into xdg crate 2026年06月13日 19:24:34 +02:00
CODE_OF_CONDUCT.md add the cofe of conduct 2026年06月16日 00:09:40 +02:00
CONTRIBUTING.md update contribution document 2026年06月15日 23:31:35 +02:00
LICENSE change license to mpl-2.0 2026年05月04日 14:55:08 +02:00
README.md add templates documentation to README.md 2026年06月01日 15:43:35 +02:00

Aerbox

Aerbox is a distrobox/toolbx-like development container tool using AerynOS tooling. It manages rootless AerynOS containers and provides integration with the host system.

It is still in early development, so expect bugs and weirdness.

Compiling

$ cargo build

Installing via cargo

$ cargo install --path .
$ mkdir -p ~/.config/aerbox
$ cp -r templates ~/.config/aerbox/

Installing via moss

(This will work whenever we have our first release.)

# moss it aerbox

Usage

Creating a container named example:

$ aerbox create example
$ aerbox start example
$ aerbox enter example

Updating the packages on the container, this does not require a restart:

$ aerbox edit -s example
$ aerbox sync -u example

Updating the container configuration, this does require a restart:

$ aerbox edit -c example
$ aerbox restart example

For more usage help, use aerbox --help.

Templates

Aerbox will look for templates in:

  • .config/aerbox/templates
  • /etc/aerbox/templates
  • /usr/share/defaults/aerbox/templates

The first one found will be the one used.

A template consists of two files, system-model.kdl and container-config.kdl, have a look at templates/default in the repository to see how they're structured.

License

This project is licensed under the Mozilla Public License 2.0.