Choose a supported deployment
Choose the installation that matches the host where agents will run:Install the macOS desktop app
Download the macOS app from podium.do/download, which picks the Apple silicon or Intel build for your Mac. Open the disk image, drag Podium to Applications, and open it. The packaged app starts its local services for you.Install on Linux
The headless installer downloads a signed, architecture-matched bundle and installs it under~/.local/share/podium. Run:
podium is not yet on PATH. You can also update the current shell:
Set
PODIUM_NO_MODIFY_PATH=1 before running the installer if your configuration manager owns shell startup files.Finish first-run setup
Run Podium after installation:18787 and prints a setup URL. Open that URL, or run podium setup in an interactive terminal.

Podium web setup modes inside a decorative macOS-style frame.
- Choose how clients and future machines reach the server
- Register at least one Git repository
- Confirm that Podium detects an installed harness and reports it logged in
Choose remote access carefully
Setup supports Tailscale Funnel, Tailscale Serve, a Cloudflare quick tunnel, or your own reverse proxy. Prefer Tailscale Serve for tailnet-only access or a stable TLS reverse proxy for a durable public endpoint.
Podium web network options inside a decorative macOS-style frame.
user:sole in the Email field and the configured Podium password in the Password field.
Cloudflare quick-tunnel URLs change on restart. Every joined machine loses contact until you run podium set-server new_server_url on that machine and restart its daemon with podium stop && podium.