henning/mailman-podman-setup
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Compare commits

base: henning:main
Branches Tags
henning:main
..
compare: henning:093cf5b90979a89dac1437883d8d601344036865
Branches Tags
henning:main

1 Commits
main ... 093cf5b909

Author SHA1 Message Date
Henning Oschwald
093cf5b909 Update README.md with setup instructions 2024-04-06 15:48:51 +02:00
1 changed files with 11 additions and 13 deletions
Expand all files Collapse all files

24
README.md
View File

@@ -3,24 +3,22 @@
Mailman 3 setup using Podman Quadlets. Containers are supposed to run in rootless mode. Mailman 3 setup using Podman Quadlets. Containers are supposed to run in rootless mode.
# requirements # requirements
- *Podman* version 4 or later - *Podman* version 4 or later
- *pwgen* to generate random secrets - *pwgen* to generatore random secrets
- an unprivileged user account to run the containers. A separate account (i.e. _mailman_ is not required, but recommended.) - an unprivileged user account to run the containers. A separate account (i.e. _mailman_ is not required, but recommended.)
# installation # installation
1. Switch to the user account you want to use to run Mailman. 1. Switch to the user account you want to use to run Mailman.
1. In the user account's home directory, create the directory where the Systemd generator looks for quadlets. 1. In the user account's home directory, create the directory where the Systemd generator looks for quadlets.
```$ mkdir -p ~mailman/.config/containers/systemd```
$ mkdir -p ~mailman/.config/containers/systemd
1. Then copy the files from the *mailman/* subdirectory in this repository into the quadlet directory: 1. Then copy the files from the *mailman/* subdirectory in this repository into the quadlet directory:
```$ cp mailman/* ~mailman/.config/containers/systemd/```
$ cp mailman/* ~mailman/.config/containers/systemd/
1. Now we have to generate some secrets which the various components use to talk to each other: 1. Now we have to generate some secrets which the various components use to talk to each other:
```
$ pwgen -1 32 | | podman secret create HYPERKITTY_API_KEY - $ pwgen -1 32 | | podman secret create HYPERKITTY_API_KEY -
$ pwgen -1 32 | podman secret create MAILMAN_REST_PASSWORD - $ pwgen -1 32 | podman secret create MAILMAN_REST_PASSWORD -
$ pwgen -1 32 | podman secret create MAILMAN_WEB_SECRET_KEY - $ pwgen -1 32 | podman secret create MAILMAN_WEB_SECRET_KEY -
1. Next adapt the environment variable definitions in mailman-core.container and mailman-web.container to your needs. You may want to customize at least the variable *SERVE_FROM_DOMAIN*, which is set to lists.example.com by default. ```
1. Now adapt the environment variable definitions in mailman-core.container and mailman-web.container to your needs. You may want to customize at least the variable *SERVE_FROM_DOMAIN*, which is set to lists.example.com by default.
1. Finally run ```$ systemctl --user daemon-reload``` to trigger the systemd unit generator and start the services: 1. Finally run ```$ systemctl --user daemon-reload``` to trigger the systemd unit generator and start the services:
$ systemctl --user start mailman-core mailman-web ```systemctl --user start mailman-core mailman-web```
1. By default Systemd launches user services only when the user logs in. To create a user session when the system boots, enable the automatic user session creation on boot with the following command as root: 1. By default Systemd launches user services only when the user logs in. To create a user session when the system boots, enable the automatic user session creation on boot with the following command as root:
```# systemctl enable-linger mailman```
# loginctl enable-linger mailman