unraid-podman/CHANGELOG.md

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning for the plugin version (independent of the bundled Podman/upstream package versions, see docs/ARCHITECTURE.md).

Unreleased

Added

• Containers panel: folders to group containers (name + optional icon URL), purely cosmetic organizational metadata stored in the plugin's own folders.json — podman itself has no such concept, same as Unraid's own Docker page's folders. "+ New Folder", a "Move to Folder" submenu on each container's row menu, and per-folder rename/delete (deleting a folder only ungroups its containers, never touches them). A folder with nothing assigned yet still shows up (so there's somewhere to move a container into); one that's merely hidden by the current search/filter does not. A folder's header always shows an icon+name+status chip per member — collapsed or expanded, matching how Unraid's own Docker page folders behave — rather than hiding everything behind a bare count; clicking a chip opens the same row menu the "⋮" button does (Details is now a menu item there too, alongside Pause/Kill/Rename/Edit/Remove) rather than jumping straight to the detail modal. "Move to Folder" only shows for a container that isn't grouped yet — once it's in one, that item becomes a direct "Remove from Folder" instead, since "move to a folder" reads as "add" and is ambiguous/redundant once it's already in one. Containers can also carry an icon URL (settable in the create/edit form, auto-filled when creating from a template) shown in the table instead of the 2-letter initials avatar.
• Containers can now carry a WebUI URL too (create/edit form, preserved through Update/Update All the same way the icon URL is), shown as a small open-in-new-tab button next to the name in the Containers table when set. Both this and the icon are stored as the plugin's own container labels (podman-webui.weburl/.icon), read straight off the already-fetched container list — no extra per-container calls.
• Container detail modal: 5 new tabs (Resources, Logs, Console, Events, Healthcheck), rounding it out from 6 to 11 of prompt.md's 12 requested tabs (Volumes was left merged into the existing Mounts tab — same underlying source/destination data, a separate tab would just repeat it). Resources shows live CPU/memory alongside configured limits (memory/swap/CPU/PIDs/block-I/O — a 0 in podman's own HostConfig means "unlimited", not zero). Logs reuses the existing per-container logs endpoint. Console opens a real ttyd/podman-exec session scoped to the modal, cleaned up (killing the ttyd process server-side) on every way of leaving — switching tabs, Close, backdrop click, or Escape — not just on an explicit Disconnect, so peeking at a console doesn't leak an orphaned ttyd process. Events and Healthcheck are both one-shot historical queries (libpod's /events?stream=false for the last 7 days, and inspect's own State.Health.Log) rather than a live stream, which stays out of scope (see dashboard.js's own note on why).
• A real toast notification system (success/warning/error/info, auto- dismissing, stacked bottom-right, dismissible early) replacing every alert() used for one-way feedback across Containers, Images, Volumes, Networks, Pods, Templates, Compose, and Settings — confirmations stay native confirm() (a decision, not a notice), and long command output (podman compose up/down, previously also an alert()) now goes to the existing scrolling log-modal instead, which fits it better than a toast ever could.
• Dashboard reworked: a clean 6-tile row of plain counts (Running, Stopped, Pods, Images, Volumes, Networks — colored green/red on Running/Stopped so fleet health reads at a glance), a single "Resource Usage" card with aligned CPU/Memory/Swap/Storage meter rows (bars shift to warn/bad colors above 75%/90% instead of staying accent-colored at any value), and an "Autostart Queue" table (reusing podman-autostart.sh's own per-container failure counters, so it shows exactly what that script would decide, not a second tracked history). Bar-and-percentage metrics were kept out of the plain-count tile grid entirely after an earlier attempt at combining them (a tile spanning multiple grid columns) left dead, empty cells in the layout.
• Dashboard and Containers now auto-refresh every ~2s (paused while the tab is hidden or a modal is open) instead of requiring a manual Refresh click to see current state.
• Settings: an "Add container" dropdown + button above the Autostart order table — previously that table could only reorder/remove containers already in the chain, with no way to add one in the first place.
• Containers: "Update All" now also removes the old, now-unused image version each updated container leaves behind (only when at least one container actually updated), instead of leaving stale images to pile up on disk after every update run.

Fixed

• Dashboard memory usage was calculated from libpod's raw memFree (which excludes reclaimable buffers/cache), showing usage far higher than reality — e.g. 67% "used" where free -h reported 19%. Now reads /proc/meminfo's MemAvailable directly, matching what free -h and most monitoring tools show.
• Dashboard CPU usage never changed — libpod's own /info computes cpuUtilization once and never resamples it (confirmed live: three calls seconds apart returned byte-identical numbers). Now computed from /proc/stat deltas between successive requests, the same technique top/htop use, which auto-refresh's ~2s cadence fits naturally.
• Context menus (a container's "⋮", a folder's "⋮") always dropped down from the anchor at a fixed position — opened from a row near the bottom of the viewport, the menu ran off-screen with its last items unreachable. Now measures its own actual rendered size (which varies with item count) after appending and flips above the anchor instead when there isn't enough room below, clamped horizontally too.
• Expanding/collapsing a folder shifted every column (including the header text) in the Containers table — its default table-layout: auto sizes each column from the widest content among only the currently-visible rows, so adding/removing a folder's rows changed what counted as "widest" on every toggle. Columns now use explicit fixed widths that don't depend on row content at all.
• The Name column's content (icon + name + WebUI button) was misaligned with its own header, drifting further off with every row — putting display:flex directly on the <td> (to keep the WebUI button on the same line as the name) pulls that cell out of table-cell layout entirely, so with table-layout:fixed it stopped respecting the column width its <th> assigns. The flex layout now lives on a <div> inside the <td> instead, so the <td> itself stays a normal, fixed-width table cell.

[0.1.3] - 2026-07-12

Added

• Settings: a "Podman Service" card with live status plus Start/Stop/Restart, each shown in a progress log modal — diagnosing and recovering a podman that failed to start no longer needs SSH/terminal access at all.
• Settings: "Format a Disk for Podman Storage", for a single-disk system with no cache pool. Only ever lists disks with no existing partition, filesystem, or RAID/ZFS membership signature, and never the Unraid boot flash — both excluded by multiple independent checks, not just one. Formatted disks are remounted by UUID on every boot.

Fixed

• STORAGE_PATH was never auto-created, even when its parent (a real, already-mounted cache pool) existed — only failed if genuinely nothing was mounted at all. Root cause of a real "cannot reach the Podman API socket" report on a fresh install with a perfectly normal cache pool.
• Cache-busting for the WebUI's own JS/CSS never actually worked, at all, the entire time — Unraid runs .page PHP through eval(), and __DIR__ inside eval()'d code resolves to the eval() call site's directory, not the plugin's. Every "hard refresh" this project's own docs/commits ever recommended only worked because Ctrl+Shift+R bypasses the browser cache directly, independent of this (broken) mechanism.
• Settings' service status chip showed "Not running" immediately after a successful Start, because the "is it running" check only recognized rc.podman status's own wording, not start/stop/restart's.
• The Podman Service log showed rc.podman's multi-line output as one run-together paragraph (missing white-space: pre-wrap on the pane itself, not just its per-line children).

[0.1.1] - 2026-07-12

Fixed

• plugin/podman.plg's <URL>/<MD5> entity values were split across their own lines (<URL>\n&baseURL;/...\n</URL>) — Unraid's plugin manager passes that text straight into a wget ... -O <name> <url> shell command without trimming it, so the leading newline broke the command in two: wget saw no URL argument at all, and the URL text ran on the next line as its own (failing) shell command. Every real Unraid plugin (verified against unassigned.devices.plg on a live host) keeps <URL>...</URL> on one line — found by running the plugin installer's own CLI (scripts/plugin install) directly on a real Unraid host and reading its raw output, rather than trusting the webGUI's summarized install log.

[0.1.0] - 2026-07-12

Added

• Initial repository scaffolding: directory structure, documentation skeleton, CI workflow stubs, and community health files.
• Architecture documentation (docs/ARCHITECTURE.md).