From d9695088c7dfc8d3d36b10c58b20818812b19248 Mon Sep 17 00:00:00 2001
From: 4liceD <95102992+4liceD@users.noreply.github.com>
Date: Tue, 23 Jun 2026 10:37:15 +0200
Subject: [PATCH] Add Podman Quadlet instructions to Readme

Added example for using VW as Podman Quadlet to Readme. Added 'docker compose up -d' as context to docker compose example.
---
 README.md | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)

diff --git a/README.md b/README.md
index 0b24ba69..9218cd58 100644
--- a/README.md
+++ b/README.md
@@ -109,6 +109,41 @@ services:
     ports:
       - 127.0.0.1:8000:80
 ```
+Afterwards run `docker compose up -d` from within the folder that contains the `compose.yaml`
+
+### Podman Quadlet
+
+If you are using Podman, you can use Quadlets to automatically generate systemd services for your containers. You will need to create a `vaultwarden.container` file.
+
+**Choose your setup:**
+* **Rootless (Recommended):** Place the file in `~/.config/containers/systemd/`
+* **Rooted (System-wide):** Place the file in `/etc/containers/systemd/`
+
+Create the file with the following configuration:
+
+```ini
+[Unit]
+Description=Vaultwarden Server
+After=network-online.target
+
+[Container]
+Image=docker.io/vaultwarden/server:latest
+ContainerName=vaultwarden
+Environment=DOMAIN="https://vw.domain.tld"
+# %h resolves to the user's home directory in rootless mode
+Volume=%h/vw-data:/data:Z,U
+PublishPort=127.0.0.1:8000:80
+
+[Install]
+WantedBy=default.target
+```
+
+Once the file is saved, reload systemd to generate the service, and start it. The following commands are for the **recommended rootless** setup:
+
+```shell
+systemctl --user daemon-reload
+systemctl --user start vaultwarden
+```
 
 <br>