mirror/docker-mailserver.docker-mailserver
1
0
Fork 0
mirror of https://github.com/docker-mailserver/docker-mailserver.git synced 2025-07-31 08:04:46 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions 1

Update docs/content/config/advanced/podman.md

Browse source
This commit is contained in:
Brennan Kinney 2025-05-06 18:01:13 +12:00 • committed by GitHub
parent ec47a654dc
commit 54c983dc20
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 51 additions and 51 deletions
Download patch file Download diff file Expand all files Collapse all files

102
docs/content/config/advanced/podman.md
View file

@ -130,66 +130,66 @@ docker compose ps
2. Run [`systemctl --user daemon-reload`][systemd-docs::systemctl::daemon-reload], which will trigger the Quadlet service generator. This command is required whenever you adjust config in `dms.container`. 2. Run [`systemctl --user daemon-reload`][systemd-docs::systemctl::daemon-reload], which will trigger the Quadlet service generator. This command is required whenever you adjust config in `dms.container`.
3. You should now be able to start the service with `systemctl --user start dms`. 3. You should now be able to start the service with `systemctl --user start dms`.
```ini title="dms.container" ```ini title="dms.container"
[Unit] [Unit]
Description="Docker Mail Server" Description="Docker Mail Server"
Documentation=https://docker-mailserver.github.io/docker-mailserver/latest Documentation=https://docker-mailserver.github.io/docker-mailserver/latest
[Service] [Service]
Restart=always Restart=always
# Optional - This will run before the container starts: # Optional - This will run before the container starts:
# - It ensures all the DMS volumes have the host directories created for you. # - It ensures all the DMS volumes have the host directories created for you.
# - For `mkdir` command to leverage the shell brace expansion syntax, you need to run it via bash. # - For `mkdir` command to leverage the shell brace expansion syntax, you need to run it via bash.
ExecStartPre=/usr/bin/bash -c 'mkdir -p %h/volumes/%N/{mail-data,mail-state,mail-logs,config}' ExecStartPre=/usr/bin/bash -c 'mkdir -p %h/volumes/%N/{mail-data,mail-state,mail-logs,config}'
# This section enables the service at generation, avoids requiring `systemctl --user enable dms`: # This section enables the service at generation, avoids requiring `systemctl --user enable dms`:
# - `multi-user.target` => root # - `multi-user.target` => root
# - `default.target` => rootless # - `default.target` => rootless
[Install] [Install]
WantedBy=default.target WantedBy=default.target
[Container] [Container]
ContainerName=%N ContainerName=%N
HostName=mail.example.com HostName=mail.example.com
Image=docker.io/mailserver/docker-mailserver:latest Image=docker.io/mailserver/docker-mailserver:latest
PublishPort=25:25 PublishPort=25:25
PublishPort=143:143 PublishPort=143:143
PublishPort=587:587 PublishPort=587:587
PublishPort=993:993 PublishPort=993:993
# The container UID for root will be mapped to the host UID running this Quadlet service. # The container UID for root will be mapped to the host UID running this Quadlet service.
# All other UIDs in the container are mapped via the sub-id range for that user from host configs `/etc/subuid` + `/etc/subgid`. # All other UIDs in the container are mapped via the sub-id range for that user from host configs `/etc/subuid` + `/etc/subgid`.
UIDMap=+0:@%U UIDMap=+0:@%U
# Volumes (Base location example: `%h/volumes/%N` => `~/volumes/dms`) # Volumes (Base location example: `%h/volumes/%N` => `~/volumes/dms`)
# NOTE: If your host has SELinux enabled, avoid permission errors by appending the mount option `:Z`. # NOTE: If your host has SELinux enabled, avoid permission errors by appending the mount option `:Z`.
Volume=%h/volumes/%N/mail-data:/var/mail Volume=%h/volumes/%N/mail-data:/var/mail
Volume=%h/volumes/%N/mail-state:/var/mail-state Volume=%h/volumes/%N/mail-state:/var/mail-state
Volume=%h/volumes/%N/mail-logs:/var/log/mail Volume=%h/volumes/%N/mail-logs:/var/log/mail
Volume=%h/volumes/%N/config:/tmp/docker-mailserver Volume=%h/volumes/%N/config:/tmp/docker-mailserver
# Optional - Additional mounts: # Optional - Additional mounts:
# NOTE: For SELinux, when using the `z` or `Z` mount options: # NOTE: For SELinux, when using the `z` or `Z` mount options:
# Take caution if choosing a host location not belonging to your user. Consider using `SecurityLabelDisable=true` instead. # Take caution if choosing a host location not belonging to your user. Consider using `SecurityLabelDisable=true` instead.
# https://docs.podman.io/en/latest/markdown/podman-run.1.html#volume-v-source-volume-host-dir-container-dir-options # https://docs.podman.io/en/latest/markdown/podman-run.1.html#volume-v-source-volume-host-dir-container-dir-options
Volume=%h/volumes/certbot/certs:/etc/letsencrypt:ro Volume=%h/volumes/certbot/certs:/etc/letsencrypt:ro
# Podman can create a timer (defaults to daily at midnight) to check the `registry` or `local` storage for detecting if the # Podman can create a timer (defaults to daily at midnight) to check the `registry` or `local` storage for detecting if the
# image tag points to a new digest, if so it updates the image and restarts the service (similar to `containrrr/watchtower`): # image tag points to a new digest, if so it updates the image and restarts the service (similar to `containrrr/watchtower`):
# https://docs.podman.io/en/latest/markdown/podman-auto-update.1.html # https://docs.podman.io/en/latest/markdown/podman-auto-update.1.html
AutoUpdate=registry AutoUpdate=registry
# Podman Quadlet has a better alternative instead of a volume directly bind mounting `/etc/localtime` to match the host TZ: # Podman Quadlet has a better alternative instead of a volume directly bind mounting `/etc/localtime` to match the host TZ:
# https://docs.podman.io/en/latest/markdown/podman-run.1.html#tz-timezone # https://docs.podman.io/en/latest/markdown/podman-run.1.html#tz-timezone
# NOTE: Should the host modify the system TZ, neither approach will sync the change to the `/etc/localtime` inside the running container. # NOTE: Should the host modify the system TZ, neither approach will sync the change to the `/etc/localtime` inside the running container.
Timezone=local Timezone=local
Environment=SSL_TYPE=letsencrypt Environment=SSL_TYPE=letsencrypt
# NOTE: You may need to adjust the default `NETWORK_INTERFACE`: # NOTE: You may need to adjust the default `NETWORK_INTERFACE`:
# https://docker-mailserver.github.io/docker-mailserver/latest/config/environment/#network_interface # https://docker-mailserver.github.io/docker-mailserver/latest/config/environment/#network_interface
#Environment=NETWORK_INTERFACE=enp1s0 #Environment=NETWORK_INTERFACE=enp1s0
#Environment=NETWORK_INTERFACE=tap0 #Environment=NETWORK_INTERFACE=tap0
``` ```
??? info "Systemd specifiers" ??? info "Systemd specifiers"