maggesandClaude Sonnet 5 3133d45d74
Build Packages / Build .txz packages (push) Failing after 3m40s
Lint / ShellCheck (push) Successful in 9s
Lint / Validate .plg XML (push) Successful in 9s
Lint / EditorConfig (push) Successful in 10s
Fix CI: add cmake and its transitive runtime deps to the toolchain bootstrap
yajl (needed by conmon, bootstrapped from source since Slackware ships
no package for it) builds via CMake, not the cmake-free autoconf script
its ./configure wrapper name suggests. Tracing the failure through the
actual vbatts/slackware:15.0 image on the runner host surfaced a chain
of packages slackpkg does not auto-resolve (Slackware packages carry no
dependency metadata at all): cmake needs libarchive, which needs lz4 and
libxml2; the patched make/gmake this mirror serves needs guile, which
needs gc; compiling anything needs kernel-headers for <linux/errno.h>;
and this build's binutils (ar/ranlib) needs flex, while objdump needs
elfutils. All added to the same slackpkg install list as the rest of
the toolchain, keeping everything on one mutually consistent version
set. Verified end-to-end against vbatts/slackware:15.0 on the actual
runner host at each step of this dependency chain.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-07-11 15:07:18 +00:00
2026-07-11 12:24:23 +02:00

unraid-podman

A native Unraid plugin that integrates Podman as a first-class container engine, running alongside Docker.

Status: architecture / scaffolding stage. No functional code has been shipped yet. This repository currently defines the target structure and design; see docs/ARCHITECTURE.md for the full technical plan and docs/ROADMAP.md for what's coming.

Goals

  • Run rootful Podman on Unraid with full persistence across reboots (config, images, containers, volumes, networks) despite Unraid's RAM-root design.
  • Coexist cleanly with Docker — no shared storage, network, or firewall conflicts.
  • Follow Unraid's native conventions: .plg installation, Slackware .txz packages, BSD-style rc.d init scripts (no systemd), config on /boot, data on the array/cache.
  • Provide a WebUI in the Dynamix style once the CLI-driven core is stable.
  • Eventually make Docker optional/disable-able once feature parity is reached.

See docs/ARCHITECTURE.md for the full rationale behind every decision below.

Repository structure

.
├── .github/            CI workflows, issue/PR templates, community health files
├── assets/             Icons, screenshots, branding used by the plugin & GUI
├── config/             Default containers/storage/registries config templates
├── docs/               Architecture, install guide, FAQ, troubleshooting, roadmap
├── packages/           Slackware .txz build recipes (podman, conmon, crun, netavark, ...)
├── plugin/             The .plg manifest, rc.d init script, sbin helper scripts,
│                       and the default files deployed to /boot/config/plugins/podman
├── scripts/            Build, release, and developer tooling scripts
└── webui/              Dynamix-style WebUI pages (plugins/podman/), added in a later phase

Installation

Not yet available. Once packages and the .plg manifest are published, installation will be the standard Unraid flow: Plugins → Install Plugin with the .plg URL, or via the Unraid Community Applications store once listed there.

Documentation

  • Architecture — full technical design (directory layout, packaging, init scripts, persistence, networking, autostart, updates, rollback, logging, error handling, future WebUI).
  • Roadmap — phased delivery plan.
  • Install guide — end-user installation steps (draft).
  • Troubleshooting — common problems and diagnostics.
  • FAQ

Contributing

Contributions are welcome — see CONTRIBUTING.md for the dev workflow, coding conventions, and how the packaging pipeline works. Please also review our Code of Conduct.

Security

Rootful Podman's API socket is root-equivalent. See SECURITY.md for the vulnerability disclosure process and known security considerations.

License

Licensed under the MIT License.

S
Description
No description provided
Readme MIT
1 MiB
2026-07-13 23:53:59 +02:00
Languages
JavaScript 29.5%
PHP 28.1%
Shell 25.1%
HTML 9.5%
CSS 7.8%