Schnellstart

Aktualisiert am 2026-08-13

Ein Standort kommt in drei Schritten dazu: Kunde und Standort in der Plattform anlegen, den Agenten beim Kunden installieren und aufnehmen, das Gerät umstellen. Die Aufnahme über die Plattform gibt es noch nicht. Was heute geht, ist der Agent für sich genommen, eingerichtet auf der Kommandozeile, und das ist es, was auf dieser Seite steht.

Davor steht die Tenant-Seite: eine App-Registrierung im Microsoft-365-Tenant des Kunden, mit Administratorzustimmung, beschränkt auf das Postfach, aus dem dieser Standort senden soll. Schritt für Schritt steht das unter Entra ID einrichten.

Der Agent speichert alle Daten unter %ProgramData%\Mailwerk\Relay\ unter Windows und unter /var/lib/mailwerk/ auf anderen Betriebssystemen. Überschreiben Sie das mit MAILWERK_DATA_DIR.

# 1. Die Zugangsdaten der App-Registrierung aus dem Tenant des Kunden speichern. Das
#    Secret wird von stdin gelesen, damit es weder in der Shell-Historie noch in der
#    Prozessliste auftaucht.
mailwerk add-credential -name "Contoso tenant" -tenant <tenant-id> -client-id <client-id>

# 2. Ein Gerätelogin anlegen. Die Absenderadresse wird jeder Nachricht, die dieses
#    Login einliefert, fest zugeordnet - unabhängig davon, was das Gerät angibt.
mailwerk add-account -username printer-2og -password <device-password> \
    -from scan@example.com -credential <credential-id>

# 3. Die Tenant-Seite prüfen, bevor Sie einen Drucker anfassen.
mailwerk test-credential <credential-id>

# 4. Starten.
mailwerk serve

test-credential meldet die Absenderadresse, die Graph tatsächlich auf eine Nachricht stempeln würde. Weicht sie von der konfigurierten Adresse ab - was bei einem Alias statt der primären Postfachadresse passiert -, wird das gemeldet. Prüfen Sie das, bevor Sie Geräte verkabeln, nicht danach.

mailwerk status zeigt Instanz-Identität, Konten- und Zugangsdaten-Anzahl sowie den Warteschlangenstatus. mailwerk list-credentials zeigt IDs und die Ergebnisse der letzten Prüfung.

Das wiederholen Sie pro Standort. Jeder Standort bekommt seinen eigenen Agenten, mit den Zugangsdaten aus dem Tenant seines eigenen Kunden.

Was sich mit der Plattform ändert

Sobald die Aufnahme steht, meldet sich der Agent beim ersten Start mit einem Registrierungsschlüssel an seinem Standort an, statt lokal eingerichtet zu werden. Wie das in der Oberfläche aussieht, steht hier, sobald es sie gibt, und nicht vorher.