whatisgithub

What is berth?

tofa84/berth — explained in plain English

Analysis updated 2026-05-18

34SwiftAudience · developerComplexity · 4/5LicenseSetup · moderate

In one sentence

berth is a native macOS graphical app, similar to Docker Desktop, for managing Linux containers through Apple's own apple/container engine on Apple silicon.

Mindmap

mindmap
  root((berth))
    What it does
      GUI for apple container
      Live logs and stats
      Manages images volumes
    Tech stack
      Swift
      SwiftUI
      XPC
    Use cases
      Run local containers
      Inspect container logs
      Manage images and volumes
    Audience
      Mac developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Manage Linux containers on Apple silicon Macs through a Docker-Desktop-style interface.

USE CASE 2

Watch live container logs, CPU, and memory stats without using the command line.

USE CASE 3

Pull, inspect, and prune container images and manage volumes and networks visually.

What is it built with?

SwiftSwiftUIXcodeXPC

How does it compare?

tofa84/berthkiraa-ai/project-onyxbleeeet/termipet
Stars343433
LanguageSwiftSwiftSwift
Setup difficultymoderatemoderateeasy
Complexity4/53/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires macOS 26 on Apple silicon, apple/container installed separately, and manual Gatekeeper approval since the app is unsigned.

MIT license: use, modify, and distribute freely, including for commercial purposes, as long as the copyright notice is kept.

So what is it?

berth is a native macOS app for managing Linux containers through apple/container, Apple's tool for running Linux containers as lightweight per-container virtual machines on Apple silicon computers. Think of it as a Docker-Desktop-style graphical interface, but built specifically for Apple's own container engine instead of Docker. It talks to that engine directly, without going through a separate background daemon or shelling out to command line tools for the important parts, which gives it real streaming logs and live stats in a proper Mac interface. The app covers the everyday container workflow across eight screens. A Dashboard shows running and total container counts, disk usage, and live CPU and memory gauges with a history chart. A Containers screen lets you search, filter, start, stop, kill, restart and delete containers, with detail tabs for configuration, live logs, live stats, and a raw JSON view. An Images screen lets you pull, delete and prune images, and view their layer history. There are also screens for managing Volumes, Networks, and registry logins stored in the macOS keychain, plus a Run screen that builds a container run command with a live preview of exactly what will execute. One feature, building images, is not yet implemented and is currently a placeholder. Installation means downloading a disk image from the project's releases page and installing apple/container separately, since berth is only a front end for it, not a replacement. Because the app is not signed with a paid Apple developer account, macOS will block it on first launch, and the README walks through the one-time approval steps needed in System Settings. Under the hood, berth adds apple/container as a Swift package dependency and calls its client code directly from a single actor that handles all communication with the engine, keeping that work off the main thread. It requires a Mac with Apple silicon running macOS 26, plus Xcode 26 to build it yourself, and it deliberately runs without Apple's App Sandbox, similar to how Docker Desktop operates, because the sandbox would block the connection it needs to the container engine. The project is released under the MIT license.

Copy-paste prompts

Prompt 1
Walk me through installing apple/container and berth on my Apple silicon Mac.
Prompt 2
Explain why macOS blocks berth on first launch and how to approve it safely.
Prompt 3
Show me how to build berth from source using Xcode and the command line.
Prompt 4
What is the difference between berth's Run screen and typing a container run command myself?

Frequently asked questions

What is berth?

berth is a native macOS graphical app, similar to Docker Desktop, for managing Linux containers through Apple's own apple/container engine on Apple silicon.

What language is berth written in?

Mainly Swift. The stack also includes Swift, SwiftUI, Xcode.

What license does berth use?

MIT license: use, modify, and distribute freely, including for commercial purposes, as long as the copyright notice is kept.

How hard is berth to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is berth for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.