Redmine Smart-Home-Integration, kostenlos und Open Source
Redmine-Tickets: offen, mir zugewiesen, überfällig; Auslöser und Tickets aus einer Szene erstellt.
Veröffentlicht von guim31
- Geräte
- Version 1.0.0
- Erfordert Gladys >=5.1.0
- ★ 0
Die Tickets deines Redmine in Gladys: wie viele offen sind, dir zugewiesen, überfällig, heute fällig, heute aktualisiert. Eine Szene reagiert auf ein neues Ticket, auf ein dir zugewiesenes Ticket, auf ein Ticket, das überfällig wird, oder auf ein geschlossenes Ticket, und Gladys kann selbst ein Ticket erstellen, wenn es etwas zu tun erkennt: ein Wasserleck, einen zu wechselnden Filter, einen Drucker, der nicht mehr antwortet.
Feedback welcome – Rückmeldungen willkommen. Diese Integration wurde gegen ein echtes Redmine getestet (das offizielle Docker-Image
redmine6.1, Oktober 2026), aber noch nicht im Alltag auf einem echten Tracker. Wenn etwas nicht wie beschrieben funktioniert, sag es im Gladys-Forum oder in den Issues.
Was du brauchst
- Gladys Assistant 5.1.0 oder neuer.
- Redmine 4.2 oder neuer, selbst gehostet oder gehostet (Planio, ein eigener Server im Internet), von Gladys aus erreichbar.
- Einen Redmine-Benutzer, in dessen Namen Gladys die Tickets liest und
erstellt: deinen oder einen eigens angelegten (
gladys), Mitglied der zu verfolgenden Projekte mit einer Rolle, die Tickets sehen, anlegen und Notizen hinzufügen darf (die Standardrolle Entwickler darf das). Die Integration sieht genau das, was dieser Benutzer in Redmine sieht.
Installation
In Redmine
- Administration → Konfiguration → Reiter API: Aktiviere REST-Schnittstelle aktivieren und speichere.
- Melde dich als Benutzer von Gladys an, öffne Mein Konto und klicke in der rechten Spalte unter API-Zugriffsschlüssel auf Anzeigen: Kopiere den Schlüssel.
In Gladys
- Integrationen → installiere Redmine.
- Fülle im Bildschirm Konfiguration aus:
- Adresse: die Adresse von Redmine wie im Browser, z. B.
https://redmine.example.orgoderhttp://192.168.1.30:3000(ein Ordner/redminebleibt,/issues/…oder/projects/…werden entfernt); - API-Schlüssel: der in Schritt 2 kopierte Schlüssel;
- Projekte mit eigenem Gerät (optional): Kennungen oder Namen von
Projekten, durch Kommas getrennt, z. B.
haus, buero(höchstens 10); - Selbstsignierte Zertifikate akzeptieren: für ein Redmine unter
https://mit selbstsigniertem Zertifikat; - Aktualisierungsintervall: 1, 2, 5 (Standard) oder 10 Minuten;
- Sprache der Funktionsnamen: die Sprache der Namen der Funktionen der Geräte.
- Adresse: die Adresse von Redmine wie im Browser, z. B.
- Verbindung testen nennt den Benutzer und die Zahl der offenen, ihm zugewiesenen und überfälligen Tickets, sowie die nicht gefundenen Projekte.
- Reiter Entdecken: Füge das Gerät Redmine hinzu, und das Gerät jedes verfolgten Projekts (zum Beispiel Redmine Haus).
Geräte
Ein Gerät Redmine für alle Tickets, die der Benutzer sieht, und ein Gerät pro verfolgtem Projekt, mit fünf Zählern, die bei jedem Lesen aktualisiert werden:
| Funktion | Was sie zählt |
|---|---|
| Offene Tickets | Tickets, deren Status nicht geschlossen ist |
| Mir zugewiesene Tickets | offene Tickets, die dem Benutzer oder einer seiner Gruppen zugewiesen sind |
| Überfällige Tickets | offene Tickets, deren Fälligkeit vor heute liegt |
| Heute fällige Tickets | offene Tickets, die heute fällig sind |
| Heute aktualisierte Tickets | seit Mitternacht geänderte Tickets, offen oder geschlossen |
„Heute“ ist der Tag in der Zeitzone von Gladys. Ein Ticket ohne Fälligkeit ist nie überfällig. Die Zähler behalten ihren Verlauf und dienen als Bedingungen in Szenen („wenn Überfällige Tickets größer als 0 ist“). Ein Projektgerät zählt nur die Tickets dieses Projekts, nicht die seiner Unterprojekte.
Dashboard
Das Widget Meine Redmine-Tickets zeigt drei Kacheln (mir zugewiesen,
überfällig, heute fällig) und die acht dringendsten offenen Tickets des Benutzers:
zuerst die überfälligen (rotes Abzeichen „Überfällig“), dann die heute fälligen
(oranges Abzeichen „Heute“), dann nach Fälligkeit. Jede Zeile nennt Projekt,
Status und Priorität. Ist Redmine unter https:// erreichbar, bietet jedes Ticket
einen Link In Redmine öffnen.
Szenen
Auslöser
Die vier Auslöser filtern nach Projektname, Tracker und Priorität, geschrieben wie in Redmine (mit Großbuchstaben; leer: beliebig).
- Neues Redmine-Ticket: Ein Ticket wurde in Redmine erstellt, von einem Benutzer, per E-Mail oder von einem anderen Werkzeug. Von Gladys selbst erstellte Tickets lösen nichts aus (keine Schleife).
- Redmine-Ticket mir zugewiesen: Ein offenes Ticket ist jetzt dem Benutzer des Schlüssels (oder einer seiner Gruppen) zugewiesen: so erstellt oder neu zugewiesen.
- Redmine-Ticket überfällig: Ein offenes Ticket hat gerade seine Fälligkeit überschritten. Bei jedem Lesen geprüft: Das erste Lesen nach Mitternacht löst ihn für die am Vortag fälligen Tickets aus.
- Redmine-Ticket geschlossen: Ein beim vorigen Lesen offenes Ticket hat jetzt einen geschlossenen Status (Erledigt, Abgewiesen …).
An die Aktionen übergebene Variablen: Ticketnummer, Betreff, Projekt, Tracker, Status, Priorität, Autor, zugewiesen an, Fälligkeit und Link zum Ticket. Die Namen sind die, die Redmine in seiner Sprache anzeigt.
Die Ereignisse werden bei jedem Lesen erkannt und kommen höchstens ein Aktualisierungsintervall nach den Tatsachen an. Beim allerersten Lesen (oder nach einem Wechsel von Server oder Benutzer) nimmt die Integration den Bestand zur Kenntnis, ohne etwas auszulösen. Ein Lesen löst höchstens 30 Ereignisse aus (ein Massenimport überflutet Gladys nicht).
Aktionen
- Redmine-Ticket erstellen: erstellt ein Ticket im Namen des Benutzers des Schlüssels, der sein Autor ist. Felder: Projekt (Kennung, Name oder Nummer, Pflicht), Betreff (Pflicht), Beschreibung (optional; Szenenvariablen sind willkommen), Priorität (Name, leer: die Standardpriorität), Tracker (Name, leer: der erste des Projekts) und Mir zuweisen. Ausgaben: die Ticketnummer und ihr Link.
- Notiz zu einem Redmine-Ticket hinzufügen: fügt dem durch seine Nummer
(
125oder#125) angegebenen Ticket eine Notiz im Namen des Benutzers des Schlüssels hinzu. Die Nummer kann von einem „Redmine-Ticket erstellen“ weiter oben in der Szene oder vom Auslöser kommen. Ausgaben: Nummer und Betreff des Tickets.
Ein Projekt, eine Priorität oder ein Tracker wird über Nummer oder Namen
angegeben, ohne Rücksicht auf Groß- und Kleinschreibung oder Akzente; ein Projekt
auch über seine Kennung (haus).
Szenenideen
- Wasserleck: Der Wassermelder im Keller meldet ein Leck → Redmine-Ticket
erstellen „Wasserleck im Keller“ im Projekt
haus, Priorität Dringend, mir zugewiesen, Beschreibung mit der Uhrzeit; dann eine Gladys-Nachricht mit dem Link zum Ticket. - Morgenrunde: An jedem Wochentag um 8:00 Uhr, wenn Heute fällige Tickets des Geräts Redmine größer als 0 ist, sagt Gladys, wie viele Tickets heute fällig sind.
- Bereitschaft: Neues Redmine-Ticket gefiltert auf die Priorität Sofort → eine Telegram-Nachricht mit Betreff, Autor und Link; Redmine-Ticket überfällig → die Bürolampe wird rot; Redmine-Ticket geschlossen → zurück zu Weiß.
Fehlerbehebung
- „keine Redmine-API unter dieser Adresse“: Prüfe die Adresse (mit dem Ordner
/redmine, falls vorhanden), indem du…/issues.jsonim Browser öffnest: Redmine antwortet in JSON. - „die REST-API ist aus“: siehe Schritt 1 in Redmine. Bei ausgeschalteter API ignoriert Redmine den Schlüssel und würde nur die öffentlichen Projekte zeigen: Die Integration prüft das zuerst.
- „API-Schlüssel abgelehnt“: Der Schlüssel wurde inzwischen zurückgesetzt (Mein Konto, Zurücksetzen), oder der Benutzer ist gesperrt.
- „dem Redmine-Benutzer fehlt eine Berechtigung in diesem Projekt“: Seine Rolle im Projekt darf keine Tickets anlegen oder keine Notizen hinzufügen.
- „Projekte nicht gefunden“ (Verbindung testen): Der Benutzer ist kein Mitglied des Projekts, oder die Kennung ist falsch geschrieben.
- Die Zähler bleiben bei null: Der Benutzer ist Mitglied keines Projekts, oder seine Rolle darf die Tickets nicht sehen.
Einschränkungen
- Ein Redmine pro Installation, höchstens 10 verfolgte Projekte.
- Die 1.000 neuesten offenen Tickets werden im Detail gelesen (überfällig, heute fällig, Projektgeräte); darüber hinaus bleiben die Zähler „Offene Tickets“ und „Mir zugewiesene Tickets“ genau.
- Ein Unterprojekt wird nicht im Gerät seines Elternprojekts gezählt: Verfolge es als Projekt.
- Ein zwischen zwei Lesevorgängen erstelltes und geschlossenes Ticket löst „Neues Redmine-Ticket“ aus, aber nicht „geschlossen“.
- Benutzerdefinierte Felder, Zeiterfassung und Versionen werden nicht gelesen.
Diese Integration ist nicht mit Redmine oder seinen Autoren verbunden.
Konfigurationseinstellungen
Diese Einstellungen fragt Redmine in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Dein Redmine | section | Nein | Redmine 4.2 oder neuer, selbst gehostet oder gehostet. In Redmine: Schalte die REST-API ein (Administration, Konfiguration, API) und kopiere den API-Schlüssel eines Benutzers (Mein Konto, API-Zugriffsschlüssel, Anzeigen). Siehe Dokumentation. |
| Adresse | string | Ja | Adresse von Redmine wie im Browser, mit https:// für HTTPS und dem Ordner /redmine, falls vorhanden. |
| API-Schlüssel | secret | Ja | Der API-Schlüssel des Redmine-Benutzers, in dessen Namen Gladys handelt: Mein Konto, API-Zugriffsschlüssel, Anzeigen. |
| Optionen | section | Nein | |
| Projekte mit eigenem Gerät | string | Nein | Optional: Kennungen oder Namen von Projekten, durch Kommas getrennt (höchstens 10). Jedes bekommt ein Gerät mit eigenen Zählern. |
| Selbstsignierte Zertifikate akzeptieren | boolean | Nein | Für eine https://-Adresse mit selbstsigniertem Zertifikat. Nur für deinen eigenen Server aktivieren. |
| Aktualisierungsintervall | select | Nein | Wie oft Redmine gelesen wird: Zähler und Szenenauslöser folgen ihr. |
| Sprache der Funktionsnamen | select | Nein | Namen der Funktionen beim Hinzufügen des Geräts und an Szenen gesendete Texte. |
So installierst du Redmine in Gladys
- Öffne in Gladys Integrationen: Redmine erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-redmine:1.0.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-redmine.
Redmine benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
Redmine ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von guim31 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation