Container Desktop

English | Polski

A native, Docker Desktop-style macOS app for Apple's container CLI — manage containers, images, volumes, networks and machines from a fast SwiftUI interface instead of the terminal.

Container Desktop does not reimplement any container logic: every action shells out to the official container CLI and parses its JSON output, so what you see is always exactly what the CLI would tell you.

📘 Documentation — Compose guide, x-init tasks, host.containers.internal, troubleshooting.

Features

Containers

• List with live state, IP address and published ports (with one-click open in browser arrows); details panel with logs, live statistics, file browser, inspect and an embedded terminal (exec -it via SwiftTerm)
• Native log viewer: continuous selection, copy-all, optional timestamps and severity colouring (errors red, warnings orange) tolerant of serilog/.NET/logfmt/klog syntaxes
• Start / stop / restart / kill / remove / prune, with per-container progress indicators
• Rich Run container dialog: ports, environment variables, volumes (pick an existing volume or a local folder), resources, network, architecture (arm64 / amd64 with automatic Rosetta), entrypoint, --rm — with a live, copy-pasteable shell preview of the exact command
• Change command / configuration of an existing container: the app recreates it with the same configuration pre-filled for editing (volume data survives)
• Live image-pull progress streamed straight into the dialog
• Docker Compose: paste a docker-compose.yml and the app translates it into container run calls — project network, dependency ordering, grouped containers on the list with start/stop-all. One-off setup tasks (e.g. database creation) via the x-init: true service extension run to completion before the other services start. The host.containers.internal alias resolves to the project network's gateway (your Mac as seen from containers), and service hostnames are wired between containers via /etc/hosts (works around the broken name DNS in container 1.0.0). A "skip init tasks" toggle reruns a stack without repeating one-off setup

Live statistics

• CPU %, memory, network and disk throughput (per second), process count — refreshed every second
• Native Swift Charts with a selectable time window (1–15 min) and hover tooltips snapped to samples

Images, volumes, networks, registries, machines

• Pull and build (Dockerfile) with streamed progress, run-from-image, tag / delete / prune / inspect
• Volumes and networks: create, delete, prune, inspect; volume file browser
• Registry logins (password passed securely via stdin)
• Container machines: create, set default, stop, delete

System

• Service status with safe start/stop (verifies the result — the CLI swallows some failures), disk usage with reclaimable-space bars, builder management, local DNS domains (admin prompt handled), readable system properties and a built-in service log viewer

Designed for macOS 26

• Liquid Glass accents, colorful System Settings-style sidebar, transition states everywhere (“Stopping… (stopping containers)”), informative empty states and (i) explainers across the app
• Menu bar extra: service status, running containers with one-click stop, “stop all”, jump to any section
• Localized in English and Polish (follows the system language)

Requirements

• macOS 26 (Tahoe) on Apple Silicon
• container CLI installed (default: /usr/local/bin/container; a custom path can be set in app Settings)

Installation

From a release DMG

Download the DMG from Releases, open it and drag Container Desktop to Applications.

Note on Gatekeeper: releases are currently not notarized (no paid Apple Developer membership). On first launch macOS will warn that the app is from an unidentified developer. Open System Settings → Privacy & Security and click Open Anyway, or remove the quarantine flag manually:

xattr -dr com.apple.quarantine "/Applications/ContainerGUI.app"

Alternatively, build from source — it takes one command.

Build from source

brew install xcodegen
git clone https://github.com/sembsa/ContainerDesktop.git && cd ContainerDesktop
xcodegen generate
xcodebuild -project ContainerGUI.xcodeproj -scheme ContainerGUI \
  -destination 'platform=macOS' -derivedDataPath .build build
open .build/Build/Products/Debug/ContainerGUI.app

Tests:

xcodebuild test -project ContainerGUI.xcodeproj -scheme ContainerGUI \
  -destination 'platform=macOS' -derivedDataPath .build

Distributable DMG (ad-hoc signed, no notarization):

scripts/package.sh        # produces dist/ContainerDesktop.dmg

Architecture

SwiftUI views (per feature)  →  @Observable stores  →  ContainerCLI (actor)  →  Process(container CLI)
        │                              │                       │
   MenuBarExtra                  AppModel (root)         JSON (Codable) / line streams (AsyncStream)
   Embedded terminal (SwiftTerm, PTY)

• ContainerGUI/CLI — process execution with timeouts and watchdog, argv builder with a shell-style tokenizer, streaming line reader
• ContainerGUI/Models — Codable models mapped to real CLI JSON output
• ContainerGUI/Features/* — one store + views per section
• App runs outside the App Sandbox (it spawns an external CLI), so distribution is direct (DMG), not the Mac App Store

License

MIT