protonmail-bridge-docker/README.md

# 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 ~/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.