Files
unraid-podman/packages
maggesandClaude Sonnet 5 18b414d7b5
Build Packages / Build .txz packages (push) Successful in 9m46s
Lint / ShellCheck (push) Successful in 13s
Lint / Validate .plg XML (push) Successful in 11s
Lint / EditorConfig (push) Failing after 5s
Fix build: podman-compose.SlackBuild was missing its executable bit
Every other packages/*/*.SlackBuild is 755 — this one was created at 644
(likely from how it was originally written to disk), so
scripts/build-packages.sh's own executability check correctly refused to
run it ("No SlackBuild found/executable for 'podman-compose'"), failing
the whole build — confirmed from a real Gitea Actions run's log
(build-packages.yml run 110).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-07-12 21:40:58 +00:00
..

packages/

One subdirectory per Slackware .txz package required by the plugin, built against Unraid's Slackware base. See docs/ARCHITECTURE.md, section 5 for the full rationale (why these components, static linking preference, version pinning, build strategy).

Packages

Directory Upstream project Purpose
podman/ containers/podman Core container engine binary
conmon/ containers/conmon Container monitor process
crun/ containers/crun OCI runtime (preferred over runc)
netavark/ containers/netavark Network backend
aardvark-dns/ containers/aardvark-dns DNS for container-to-container name resolution
containers-common/ containers/common Default config/seccomp/registries templates
fuse-overlayfs/ containers/fuse-overlayfs Fallback storage driver (rootless, Phase 2)
passt/ passt.top (no GitHub mirror) Rootless networking (Phase 2), successor to slirp4netns
unraid-podman/ this repository (not an upstream project) Plugin's own scaffolding — rc.podman, sbin/ scripts, event/ hooks, config templates (see its README)

podman, conmon, crun, netavark, aardvark-dns, passt, fuse-overlayfs, and unraid-podman are built and released automatically by .github/workflows/build-packages.yml. containers-common currently only supplies reference config (see config/) and is not yet wired into the automated build.

Standard layout per package

Each package directory follows the same skeleton:

packages/<name>/
├── <name>.SlackBuild   # Slackware build script (source download, build, packaging)
├── slack-desc            # Slackware package description (max 70 cols / 11 lines)
├── patches/               # Optional patches applied during the build
└── README.md              # Upstream version pinned, build notes, patch rationale

Build pipeline

Packages are built via scripts/build-packages.sh, which runs each package's <name>.SlackBuild in turn (see scripts/lib/slackbuild-common.sh for the shared fetch/verify/package helpers they all use). This must run inside a Slackware-compatible build environment — never on an arbitrary host distro, to avoid glibc/ABI drift against Unraid's base. .github/workflows/build-packages.yml is the CI entry point: it runs the same script inside a pinned Slackware container (scripts/ci/setup-slackware-buildenv.sh bootstraps any build-time dependency the base image doesn't already ship) and uploads the results as a workflow artifact — nothing built is ever committed to this repository.

Exact upstream versions and source checksums are pinned centrally in versions.env (update via scripts/update-versions.sh, never by hand) and, at release time, mirrored into the top-level plugin/podman.plg manifest together with MD5 checksums by scripts/release.sh, so installs are reproducible and rollback-able — see docs/ARCHITECTURE.md, section 14 (Rollback).