Install

curl -fsSL https://udon.sh/install | sh

This downloads the latest release, installs container if it's missing, and runs Udon as a per-user service that starts at login. It also adds a menu bar app. Re-running it upgrades in place — nothing to build, no Xcode, no toolchain.

To build from source instead, clone the repo and run make install (needs Swift 6.2 and Node 22 with pnpm).

When it finishes, open the printed address — https://your-mac.local:4443 — and create the first account. That account is the administrator.

Building from source needs Swift 6.2 (Xcode 26) and Node 22 with pnpm. A prebuilt Homebrew formula is planned.

Updating

make update

Pulls the latest source, rebuilds, and restarts the service. Your accounts, settings, and data are left in place.

Uninstalling

make uninstall              # stop and remove the service, keep your data
make uninstall ARGS=--purge # also remove the state directory

Remote access

Udon serves over TLS and is meant for your own network, not the public internet. To reach it away from home, put it behind a private network such as Tailscale rather than forwarding a port. The Network page shows the address that reaches Udon over your tailnet, can serve the UI with a trusted certificate, and can advertise the container network so you reach containers by their own IPs.