metabrainz/musicbrainz-docker v-2025-05-29.0-solr9 on GitHub

Breaking changes

This release requires Docker Compose v2 and upgrades MusicBrainz search components with SolrCloud 9, Java 17, Python 3, MusicBrainz XML metaData schema mmd-schema@v-2025-04-23, and MusicBrainz search schema mbsssss@v-2025-05-18.

See the blog post for more details.

Upgrade instructions

The below instructions are for MusicBrainz mirror with enabled replication (and optionally live indexing), adapt these to your own needs.

Assuming that your checked out version of musicbrainz-docker is v-2025-05-23-mbdb30 and that your installed version of Docker Compose is 2, then:

Turn off replication (and live indexing if enabled):

admin/configure rm replication-cron live-indexing-search
docker compose up -d

Switch to the new code with:

git fetch --tags origin
git checkout v-2025-05-29.0-solr9

Upgrade the services indexer, musicbrainz and search:
```
docker compose build
docker compose up -d
```
The search service will drop the previous Solr 7 search indexes when starting.
Purge the messages queued for the indexer:
```
admin/purge-message-queues
```

Drop the previous Solr 7 search index dumps:

( eval $( docker compose config --environment | grep COMPOSE_PROJECT_NAME ) && \
  docker volume rm "${COMPOSE_PROJECT_NAME}_searchdump" )

It is expected to output the name of the removed volume, usually musicbrainz-docker_searchdump.

Set up search indexes (as usual):
Either build search indexes manually from the installed database:
```
docker compose exec indexer python -m sir reindex
```
(During our tests it took ~12h with 4 GB memory settings.)
Or download pre-built search indexes based on the latest data dump:
```
docker compose exec search fetch-backup-archives
docker compose exec search load-backup-archives
```
(During our tests it took ~12min after downloading 60 GB of Zstandard-compressed MB Solr backup archives.)
Once you are satisfied with the search results, drop the fetched archive files:
```
docker compose exec search remove-backup-archives
```

(If live indexing was enabled, update its triggers and turn it back on:)

admin/setup-amqp-triggers uninstall
admin/setup-amqp-triggers install
admin/configure add live-indexing-search
docker compose up -d

Turn back on replication:

admin/configure add replication-cron
docker compose up -d

What's Changed

Upgrade search services and requirements by @yvanzo in #306

Full Changelog: v-2025-05-23.0-mbdb30...v-2025-05-29.0-solr9