Used Zammad version: 6.5.0-1750055263.dd6ae287.bookworm
Used Zammad installation type: package
Operating system: Debian 12
Browser + version: Irrelevant
Expected behavior:
Elasticsearch Index Rebuild functioning properly
Actual behavior:
Search Index Rebuild fails with message
“rake aborted!
Version 9.0.2 of configured elasticsearch is not supported.”
Steps to reproduce the behavior:
Install Zammad + Elasticsearch according to installation guide on docs.zammad.org, initiate an Index Rebuild via CLI command.
Install guide seems to assume Elasticsearch 8 and in some spots claims the guide is for Versions >= 8. However, it seems ES9 has made critical changes again that break the guide.
I mean you can argue that the phrasing that refers to “Version >= 8” is a bit misleading in the context. Of course it never explicitly says v9 is supported.
TBH, I wasn’t even aware during the setup phase. If you just follow the install guide, it’ll have you follow the respective guide from Elasticsearch, which has you install the most recent release. You don’t really see a version number in that process unless you’re explicitly looking for one. So, it doesn’t say v9 is supported, but it also tells you to follow setup instructions that will install a v9 ES (which you can infer from the repo name that you add to your sources.list in Debian, ref. ES setup guide ).
This isn’t really an issue with either Zammad or Elasticsearch, just the docs IMO. Would be better to point people to ES install instructions that will have the user install a supported version, I think.
I don’t understand where you get that single v8 from?
v9 must be quite new, because our documentation links to current which, up to some days ago, was version8.
Honestly, I personally think that beginning a documentation from the start is extremely helpful. Because then you’d have to go over the software page.
This is also what our installation page tells you to do imho.
What I meant:
— here should be an image that I get an error over when trying to submit the post —
In a few spots in the “Set Up Elasticsearch” article of Zammad docs, you have those mentions of “for Elasticsearch >= 8 do this”. This isn’t incorrect in that those steps will still work with v9. Just that this suggests that maybe v9 is also supported when it’s clearly more recent than the Zammad docs. No big deal, just what confused me a little.
Honestly, I personally think that beginning a documentation from the start is extremely helpful. Because then you’d have to go over the software page.
The problem here wasn’t not reading the instructions, it’s the lack of obviousness which exact version the ES install instructions will install. For someone unfamiliar with either software package, that’s almost guaranteed to get missed.
v9 must be quite new, because our documentation links to current which, up to some days ago, was version8.
I think that is the main culprit here, yep. The ES 9.0.2 package is from late May '25. It’s probably sufficient to just change the “ElasticSearch installation documentation” link in Step 1 of the “Set Up Elasticsearch” portion to this URL (which was probably what you intended to link to when v8 was the most recent ES release): https_//www.elastic.co/guide/en/elasticsearch/reference/8.18/install-elasticsearch.html
