Back to plugins
Docker & Podman Shipyard
v1.1.0 Ishan0121

About

Docker & Podman Shipyard

A unified, zero-clutter Docker and Podman manager for Wayland. It bridges the gap between atomic container management and directory-based Docker Compose workflows, strictly inheriting all visual styling and design tokens from the Noctalia desktop environment.

Plugin

Field Value
ID ishan0121/shipyard
Entries Bar widget: shipyard; panel: manager; service: daemon; shortcut: toggle

Requirements

Install docker or podman on PATH. For compose stack discovery and control, ensure docker compose or podman compose is installed. setsid (from util-linux) is used for process group management during long-running tasks.

Usage

Open the Shipyard management panel with:

noctalia msg panel-toggle ishan0121/shipyard:manager

Features

  • Persistent Header: Seamless toggle switch between Docker and Podman, with live daemon-wide CPU and RAM aggregation.
  • Stacks Tab (Compose Director): Scans configured directories for docker-compose.yml or compose.yaml. Provides Up and Down controls alongside a Deploy & Eject action that starts a stack and switches directly to the Containers view for atomic container inspection and management.
  • Containers Tab (Atomic View): Live event-stream-driven container inspection. Displays live CPU and memory usage, status badges, and inline Start, Stop, Restart, and Remove buttons.
  • Images Tab (Asset Manager): Lists downloaded images with tags, size, and container reference count, with a one-click Prune Unused Images action.
  • Infrastructure Tab (Volumes & Networks): Split view for volumes and networks, highlighting unattached orphans for quick deletion.

Settings

Setting Type Default Description
daemon_type select "docker" Active container engine ("docker" or "podman").
compose_scan_dirs string_list ["~/docker", "~/Projects", "~/Labs", "~/compose"] Directories scanned recursively for Compose files.
refresh_interval int 3 Interval in seconds for live container CPU and memory stats while panel is viewed.
confirm_destructive bool true Whether to confirm before removing containers, volumes, networks, or pruning images.
show_stats bool true Bar widget setting: Display live CPU and RAM percentages directly in the status bar.
glyph glyph "ship" Bar widget setting: Icon displayed on the top bar.

IPC

Refresh state snapshot or switch daemons externally:

noctalia msg plugin ishan0121/shipyard:daemon all refresh
noctalia msg plugin ishan0121/shipyard:daemon all toggle_daemon

Notes

  • Runtimes run asynchronously using noctalia.runAsync to ensure no blocking operations occur on the compositor thread.
  • Decoded rows are batched per Luau tick to maintain 60 FPS compositor smoothness.

Versions

VersionPlugin APIUpdated
v1.1.0 latest43Nov 19, 2026

Older versions stay installable on a Noctalia release whose plugin API is below the latest version's.