Podman

Podman is a daemonless, drop-in alternative to Docker that runs containers rootless by default — a great match for our images.

Pulling an Image

podman pull ghcr.io/trueforge-org/home-assistant:2025.5.1

Running a Container

podman run -d \
  --name home-assistant \
  --user 568:568 \
  -p 8123:8123 \
  -v home-assistant-config:/config \
  ghcr.io/trueforge-org/home-assistant:2025.5.1

Using Compose

Podman supports Compose files via podman compose or the standalone podman-compose tool. Compose snippets from our Docker Compose guide work unchanged.

Quadlets (systemd)

For long-running services, generate a Quadlet so systemd manages the container:

[Container]
Image=ghcr.io/trueforge-org/home-assistant:2025.5.1
ContainerName=home-assistant
PublishPort=8123:8123
Volume=home-assistant-config:/config
User=568:568

[Service]
Restart=always

[Install]
WantedBy=multi-user.target

Reload and start:

systemctl daemon-reload
systemctl start home-assistant