rootless podman quadlet recipe
for the Omada Software Controller. Uses pure systemd
to orchestrate the containers.
Intended to be hosted on a free tier class cloud server for home-sized networks. Utilizes mbentley's excellent Docker image.
Includes tailscale for a site to site VPN with the home network, cloudflared for exposing the controller to the internet behind zero trust authentication, and sftpgo for pushing backups from the controller to an S3 compatible storage backend.
Contents of this repository are intended to live inside
.config in your home directory. You'll need to configure
the .env file in .config/containers/systemd/omada/
for your cloudflared and tailscale keys.
To enable and start services at login:
systemctl --user start omada.target
If you make changes to any of the service files after
enabling, you need to reload the systemd daemon:
systemctl --user daemon-reload
Useful command for troubleshooting changes to the service files:
/usr/libexec/podman/quadlet --user --dryrun
which causes podman to parse the service files and check for errors.