From 28393421b158084dbf4a072bd23c2c2fc3a5fffc Mon Sep 17 00:00:00 2001 From: beertje44 <101147154+beertje44@users.noreply.github.com> Date: Thu, 27 Mar 2025 15:51:29 +0100 Subject: [PATCH] Update dovecot-solr.md --- .../examples/tutorials/dovecot-solr.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/docs/content/examples/tutorials/dovecot-solr.md b/docs/content/examples/tutorials/dovecot-solr.md index 13a9f0e7..acba1dca 100644 --- a/docs/content/examples/tutorials/dovecot-solr.md +++ b/docs/content/examples/tutorials/dovecot-solr.md @@ -146,6 +146,19 @@ docker compose exec mailserver doveadm fts rescan -A Usually within 15 minutes or so, you should be able to search your mail using the Dovecot FTS feature! :tada: +### Notes + +1. As of writing of this guide, SOLR 9.8 is the current release. This release introduces a notable [change][solr-9.8-change]: it no longer automaticly loads additional jars via directives. This behaviour is no deprecated and will be completely removed from SOLR 10 and onwards. The current dovecot scheme however does need this so you need to add an extra environment variable to your `compose.yaml` if you want to use SOLR 9.8.x: + +```yaml +... + environment: + ... + - SOLR_OPTS: "-Dsolr.config.lib.enabled=true" +``` + +2. If you use [podman][podman] the composer build 'trick' only works with more recent versions of podman-compose, more recent then the version that currently ships with [EPEL][fedora-epel] for example. You should really be using [Quadlets][podman-quadlets] though if you use podman, which is a topic of its own and doesn't fit in this tutorial. + [docs::user-patches]: ../../config/advanced/override-defaults/user-patches.md [docs::dovecot::full-text-search]: ../../config/advanced/full-text-search.md [gh-dms::feature-request::dovecot-solr-package]: https://github.com/docker-mailserver/docker-mailserver/issues/4052 @@ -154,3 +167,9 @@ docker compose exec mailserver doveadm fts rescan -A [dockerfile-solr-uidgid]: https://github.com/apache/solr-docker/blob/9cd850b72309de05169544395c83a85b329d6b86/9.6/Dockerfile#L89-L92 [github-solr]: https://github.com/apache/solr [github-dovecot::core-docs]: https://github.com/dovecot/core/tree/main/doc + +[solr-9.8-change]: https://issues.apache.org/jira/browse/SOLR-16781 + +[podman]: https://podman.io +[fedora-epel]: https://docs.fedoraproject.org/en-US/epel/ +[podman-quadlets]: https://docs.podman.io/en/latest/markdown/podman-systemd.unit.5.html