From: Vincent Kenbeek <vincent.kenbeek@open-xchange.com>
Date: Thu, 28 Nov 2024 08:58:04 +0000 (+0100)
Subject: doc: Add minimal configuration
X-Git-Tag: 2.4.0~168
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=9a6a6aef35bb403fa96f0b5efdb0faff85b1471d;p=thirdparty%2Fdovecot%2Fcore.git

doc: Add minimal configuration
---

diff --git a/configure.ac b/configure.ac
index 1f6dc9140f..36e972d040 100644
--- a/configure.ac
+++ b/configure.ac
@@ -792,6 +792,7 @@ doc/man/Makefile
 doc/index.html
 doc/example-config/Makefile
 doc/example-config/conf.d/Makefile
+doc/dovecot.conf
 src/Makefile
 src/lib/Makefile
 src/lib-sql/Makefile
diff --git a/doc/Makefile.am b/doc/Makefile.am
index 1aba64c90c..de9c79efe5 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -24,6 +24,11 @@ stamp-man:
 
 all-local: stamp-man
 
+install-data-hook:
+	$(INSTALL) -d $(DESTDIR)$(sysconfdir)/dovecot
+	test -e $(DESTDIR)$(sysconfdir)/dovecot/dovecot.conf || \
+	$(INSTALL) dovecot.conf $(DESTDIR)$(sysconfdir)/dovecot/dovecot.conf
+
 install-data-local:
 	$(MKDIR_P) $(DESTDIR)$(docdir); \
 	for dir in $(DOCDIRS); do \
diff --git a/doc/dovecot.conf.in b/doc/dovecot.conf.in
new file mode 100644
index 0000000000..26d5559f9f
--- /dev/null
+++ b/doc/dovecot.conf.in
@@ -0,0 +1,49 @@
+## Dovecot configuration file
+
+# Dovecot configuration version. This must be the first setting in the
+# configuration file. It specifies the configuration syntax, the used setting
+# names and the expected default values.
+dovecot_config_version = @DOVECOT_CONFIG_VERSION@
+
+# Dovecot storage file format version. It specifies the oldest Dovecot version
+# that must be able to read files written by this Dovecot instance. The
+# intention is that when upgrading Dovecot cluster, this setting is first kept
+# as the old Dovecot version. Once the cluster is fully upgraded to a new
+# version and there is no intention to rollback to the old version anymore,
+# this version number can be increased.
+dovecot_storage_version = @DOVECOT_CONFIG_VERSION@
+
+# The configuration below is a minimal configuration file using system user authentication.
+# See https://@DOVECOT_ASSET_URL@/configuration_manual/quick_configuration/
+
+!include_try conf.d/*.conf
+
+# Enable wanted protocols:
+protocols {
+  imap = yes
+  lmtp = yes
+}
+
+mail_home = /srv/mail/%{user}
+mail_driver = sdbox
+mail_path = ~/mail
+
+mail_uid = vmail
+mail_gid = vmail
+
+# By default first_valid_uid is 500. If your vmail user's UID is smaller,
+# you need to modify this:
+#first_valid_uid = uid-number-of-vmail-user
+
+namespace inbox {
+  inbox = yes
+  separator = /
+}
+
+# Authenticate as system users:
+passdb pam {
+}
+
+ssl_cert_file = /etc/dovecot/ssl-cert.pem
+ssl_key_file = /etc/dovecot/ssl-key.pem
+