Kompatibilität

Welche Plugin-Version auf welchem Redmine läuft.

Jede Plugin-Version unterstützt die aktuelle und die vorherige Redmine-Linie, heute 7 und 6. Diese Seite zeigt je Plugin, womit die aktuelle Version getestet ist, und in welcher Reihenfolge ein Redmine-Update abläuft, damit die Instanz durchgehend startet.

Freigabe-Übersicht

Aktuelle Versionen, getestet bei jedem Release.

Stand der Release-Pipeline. Jede Zeile ist die aktuell ausgelieferte Version des Plugins; ältere Versionen stehen weiter unten.

PluginVersionRedmine 5.1Redmine 6.0Redmine 6.1Redmine 7
Zeiterfassung 1.7.0 Freigegebengetestet Freigegebengleiche Linie wie 6.1 Freigegebengetestet Freigegebengetestet
Rechnungstellung 1.7.0 Freigegebengetestet Freigegebengleiche Linie wie 6.1 Freigegebengetestet Freigegebengetestet
Kanban Board 1.7.0 Freigegebengetestet Freigegebengleiche Linie wie 6.1 Freigegebengetestet Freigegebengetestet
Checklisten 1.7.0 Freigegebengetestet Freigegebengleiche Linie wie 6.1 Freigegebengetestet Freigegebengetestet
Mitglieder-Übersicht 1.7.0 Freigegebengetestet Freigegebengleiche Linie wie 6.1 Freigegebengetestet Freigegebengetestet
Externe Beobachter 1.0.0 Freigegebengetestet Freigegebengleiche Linie wie 6.1 Freigegebengetestet Freigegebengetestet

Ältere Versionen

Redmine 6 wird seit der ersten Version jedes Plugins unterstützt, Redmine 5.1 seit April 2026. Redmine 7 lief seit den 1.6.0-Releases im Oktober 2026 im Vorabtest und ist seit dem 7. November 2026 für die Versionen 1.7.0 und Externe Beobachter 1.0.0 freigegeben. Für Redmine 5.1 sind diese Versionen die letzten freigegebenen: neuere Versionen laden dort weiter, werden aber nicht mehr dafür freigegeben. Was sich je Version geändert hat, steht im Changelog am Ende des jeweiligen Handbuchs.

Die Regel

Aktuelle und vorherige Redmine-Linie.

Jede Plugin-Version unterstützt die aktuelle und die vorherige Redmine-Linie. Heute sind das Redmine 7 und Redmine 6. Redmine 5.1 ist mit den 1.7.0-Versionen und Externe Beobachter 1.0.0 letztmalig freigegeben und bleibt mit diesen Versionen nutzbar; die Plugins verlangen weiterhin nur 5.1.0 oder neuer, neuere Plugin-Versionen laufen dort also, werden aber nicht mehr dafür getestet und freigegeben.

Eine Plugin-Version, die zwei Redmine-Linien unterstützt, ist damit immer auch die Brückenversion für das Update von der einen auf die andere.

Erscheint während Ihrer Update-Laufzeit eine neue Redmine-Linie, ist die dafür freigegebene Plugin-Version Teil Ihrer zwölf Monate Updates. Der Update-Link aus der Kaufmail liefert sie, sobald sie freigegeben ist.

Reihenfolge beim Redmine-Update

Erst das Plugin, dann Redmine.

Redmine lädt jedes Plugin beim Start. Passt ein Plugin nicht zur neuen Redmine-Version, startet die ganze Instanz nicht, bis der Plugin-Ordner entfernt ist. Die Daten in den Plugin-Tabellen sind davon nie betroffen. Mit dieser Reihenfolge kommt es gar nicht erst dazu:

  1. Zielversion prüfen
    In der Tabelle oben nachsehen, welche Plugin-Version die Redmine-Version unterstützt, auf die Sie wechseln wollen.
  2. Plugin auf die Brückenversion bringen
    Zip entpacken, redmine:plugins:migrate, Redmine neu starten, kurz auf der alten Redmine-Version prüfen. Diese Version läuft auf beiden Redmine-Linien.
  3. Redmine aktualisieren
    Nach der Redmine-Anleitung, anschließend erneut bundle exec rake redmine:plugins:migrate RAILS_ENV=production und Neustart.
  4. Vorher auf einer Kopie durchspielen
    Backup von Datenbank und Plugin-Ordner, dann dieselben Schritte auf einer Kopie der Installation.

Fallweg ohne Brückenversion

Wenn keine Plugin-Version beide Redmine-Linien unterstützt, etwa weil das neue Redmine ein neueres Ruby verlangt: Plugin-Ordner beiseitelegen, Redmine aktualisieren, neue Plugin-Version einsetzen, migrieren. Die Plugin-Tabellen bleiben dabei unverändert in der Datenbank; die neue Version hebt das Schema mit ihren eigenen Migrationen an.

cd /pfad/zu/redmine
mv plugins/at_zeiterfassung ../at_zeiterfassung.alt   # beiseitelegen, NICHT migrieren
# Redmine aktualisieren
# neue Plugin-Version nach plugins/at_zeiterfassung entpacken
bundle exec rake redmine:plugins:migrate NAME=at_zeiterfassung RAILS_ENV=production
# Redmine neu starten

Nie VERSION=0 als Teil eines Updates. Die Rückwärtsmigration auf Version 0 löscht die Plugin-Tabellen und damit alle Daten des Plugins. Sie gehört nur zur endgültigen Deinstallation.

Dasselbe mit den Befehlen für das jeweilige Plugin steht im Kapitel „Redmine aktualisieren“ im Handbuch: Zeiterfassung, Rechnungstellung, Kanban Board, Checklisten, Mitglieder-Übersicht, Externe Beobachter.

Woher die Angaben stammen

Aus der Release-Pipeline.

Jedes Release läuft vor der Auslieferung durch dieselbe Testreihe: die Tests des Plugins auf Redmine 5.1, Redmine 6.1 und Redmine 7, jeweils mit SQLite, MySQL und PostgreSQL, also neun Durchläufe. Die Spalten 6.1 und 7 sind Pflicht, ohne grünes Ergebnis gibt es kein Zip. Die Spalte 5.1 läuft zur Information weiter und darf fehlschlagen.

Die Tabelle wird mit jedem Release aktualisiert. Die untere Grenze steht in jedem Plugin selbst (requires_redmine version_or_higher: '5.1.0'); eine harte obere Grenze gibt es bewusst nicht, damit eine neue Redmine-Version, die problemlos läuft, nicht blockiert wird.