Podman runs containers without a background daemon and, on Linux, rootless by default. On macOS it runs inside a small Linux VM that podman machine manages. I use it on my MacBook and on the VPS with the same commands: Installing Podman locally and on a VPS.
What matters in practice
- Compose:
podman-composeor the subcommandpodman compose. PinPODMAN_COMPOSE_PROVIDER, or the subcommand may calldocker-compose. - Service names: compose services find each other by name only with
netavarkandaardvark-dnsinstalled. - Quadlets: a
.containerfile in~/.config/containers/systemd/becomes a systemd service, as in Forgejo with rootless Podman. podman unshareruns a command inside the rootless user namespace, for example to give a volume the right owner.- Reboots: a restart policy covers crashes. After a reboot, a systemd unit has to start the compose stack.
- Used in
-
- Astro SSR with Podman: From Local Setup to VPS Astro with the Node standalone adapter in a two-stage Podman container, run locally with the same compose file that later goes to the VPS.
- Caddy as Reverse Proxy with HTTPS and a Canonical Host Caddy in front of a container on a VPS: automatic TLS from Let's Encrypt, www redirected to the bare domain, the app port closed to the outside.
- Deploying Astro SSR to a VPS with Podman Moving the Astro SSR container to a fresh Debian VPS: Podman from the distro packages, a read-only deploy key and the same compose file.
- Forgejo on Debian 13 with Rootless Podman Forgejo as a rootless Podman container under its own user: a Quadlet for systemd, Caddy in front, SSH on port 2222 and the problems I ran into.
- Installing Podman Locally and on a VPS Podman with podman-compose on macOS and on a Debian or Ubuntu server, with the same commands on both sides and a first-run check.
- Keeping a Compose Stack Running After a Reboot A systemd unit that starts a Podman compose stack on boot, so a website comes back by itself after the VPS restarts.
- My Old Astro Website My old site at adrian-altner.de: Astro with the Node adapter, typed content collections, IndieWeb features and photos as files with JSON sidecars.
- Obsidian to VPS Pipeline: Sync, Pull and Redeploy One shell script on the Mac that pulls the site repository on the VPS, rsyncs the posts from the Obsidian vault and rebuilds the Astro container.
- Operating Astro SSR in Production with Podman A short runbook for the Astro container on the VPS: start and stop, health checks, the four-command update, rollback by commit and Caddy checks.
- Setting Up a Forgejo Actions Runner Push-to-deploy with a self-hosted Forgejo Actions runner on the same VPS: own user, no Docker, narrow sudo rights and secrets kept in Forgejo.
- Triggering VPS Deploys with GitHub Actions A GitHub Actions workflow that opens an SSH session to the VPS on every push to main and lets the server pull and rebuild itself.
- Updating the Website Repository on a VPS A repeatable update flow on the VPS: check the working tree, pull with --ff-only, rebuild with podman-compose, verify, roll back, all in one script.
- Tags