From 4fa35da1e3e34811f3ba241fc6f6c199e71eb193 Mon Sep 17 00:00:00 2001
From: irl <irl@sr2.uk>
Date: Wed, 27 May 2026 14:21:35 +0000
Subject: [PATCH] Update README.md

---
 README.md | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/README.md b/README.md
index 0bb9d68..1043b19 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,25 @@
 # ProtonMail IMAP/SMTP Bridge Docker Container
 
+This container is part of our Link helpdesk stack.
+You may use it independently of that stack, but we probably won't support you doing that.
 
+## Initial Setup
+
+1. Launch the interactive shell:
+
+   ```
+   # Make sure the systemd service is not running
+   systemctl --user stop protonmail-bridge
+   # Start the container manually with the init command
+   podman run -it --name protonmail-bridge --replace --volume /home/link_tcn/protonmail-data:/data:rw,Z --network zammad guardianproject.dev/sr2/protonmail-bridge-docker:latest init
+   ```
+2. Login with the `login` command.
+3. Find the generated IMAP/SMTP password with the `info` command.
+4. Exit the shell with the `exit` command and restart the systemd service:
+   ```
+   systemctl --user restart protonmail-bridge
+   ```
+
+## systemd service
+
+That [systemd service](https://guardianproject.dev/sr2/ansible-collection-apps/src/branch/main/roles/podman_link/templates/home/config/containers/systemd/protonmail-bridge.container) is part of our infrastructure as code for the Link helpdesk if you're curious.