Packages and repositories

Packages are built from source by recipes that follow Linux From Scratch and Beyond Linux From Scratch. A signed repository serves them.

A package

A package is a zstd-compressed tar file. It begins with a manifest, which is authoritative for all file metadata (owners, modes, links); the archive carries the contents of regular files only.

Packages have no install scripts. A package may declare a trigger, such as rebuilding the linker cache when libraries change, as a file under /usr/lib/dave/triggers/, and that is all.

A package is everything its upstream installs. There are no split -dev or -doc packages yet, so the base system carries the compiler, because programs need its run-time libraries.

A repository

A repository is a directory of packages with an index, repo.zon, signed with Ed25519. The signed index carries the SHA-256 of every package. Repositories are fetched over HTTPS (checked against the system’s certificate store), HTTP, or from a local directory; the signature is what is trusted either way.

joe Linux’s repository is joelinux.io/x86_64. Its key, joe.pub, is already on every joe system, in /etc/dave/keys/. The downloads page says how many packages it holds and when it was last published.

Every publication is a complete new copy of the repository, switched to in one step, so an index and its signature always come from the same build.

Recipes

Each package has a recipe in the git repository, packages/NAME/: a package.zon with its version, sources, dependencies and declared operations, and a build.sh. The versions, URLs and options come from Linux From Scratch and Beyond Linux From Scratch (the systemd, development branches).

Sources

The source archive of every published package is in sources/, as the GPL asks of anyone distributing the binaries. The recipes, patches and joe Linux’s own code are on GitHub.

A few packages are not built from source alone. Some fetch their locked Rust, Go, Haskell, JavaScript or Java dependencies from the network while building. Rust, Go, GHC and OpenJDK are each first compiled by a prebuilt compiler. The TypeScript compiler is its upstream’s compiled release, and bun is upstream’s binary, repackaged. Firefox carries Mozilla’s unofficial branding, as Mozilla’s trademark policy asks of builds it has not approved; it is called Web Browser in the desktop.