Udon

Introduction

What Udon is and what it does.

Udon is a web interface for running a Mac as a home server. It runs and manages containers, watches the machine's hardware and disks, and handles user accounts — all from the browser. Everything beyond the core installs as an extension from a community repository.

Early development. The core and the first built-in extensions are still being built, and things will change without notice.

Requirements

  • Apple Silicon Mac (M1 or newer)

  • macOS 26 or later

  • container, installed and started:

    container system start

How it fits together

Udon is three parts:

  • udond — a Swift service that serves the web UI and the API, keeps the user and session store, talks to container, and reads the machine's metrics. It runs as your user account, not as root.
  • Web UI — a single-page app that udond serves.
  • Extensions — everything else. Containerized apps, panels, and integrations install as extensions; the built-in Containers, Monitoring, and Storage views are themselves extensions built on the same public API.

Next: install Udon.

On this page