Skip to content

Installation und Updates 2026.1.1

Auf dieser Seite findest du alle verfügbaren Methoden, um die Doorman-Firmware zu installieren oder zu aktualisieren. Egal, ob du die Firmware zum ersten Mal flashst oder ein Update einspielst – die Anleitungen führen dich Schritt für Schritt durch den Prozess. Dazu gehören die direkte Installation per Web Serial, Updates über die Web-Oberfläche der Firmware und die Integration in das Update-System von Home Assistant.

WICHTIG

Manche Updates können Breaking Changes mit sich bringen — lies dir die Changelogs immer genau durch, damit dein System auch in wichtigen Situationen zuverlässig funktioniert.

Web Serial Neueste Release-Version, keine Anpassungen

Verbinde deinen Doorman S3 per USB-C und nutze den Konfigurationsassistenten unten, um die neueste Firmware direkt über Web Serial zu installieren — ideal für die erstmalige Einrichtung.

Dieser geführte Prozess sorgt für eine nahtlose Integration mit der Home Assistant API und ermöglicht es dir, zukünftige Community-Updates ganz einfach zu übernehmen.

COMPUTER SAGT NEIN

Da dein Browser kein Web Serial unterstützt, ist der Konfigurations Assistent leider nicht verfügbar! Bitte verwende einen Chromium-basierten Browser.

Integrierte OTA-Updates Neueste Release-Version, keine Anpassungen

Die Firmware unterstützt direkt OTA-Updates – du kannst die neueste Version mit nur einem Klick installieren – schnell, einfach und stressfrei.

Wenn Doorman in Home Assistant integriert ist, erscheinen verfügbare Updates sogar direkt in deiner Update-Liste – so bleibst du noch bequemer auf dem neuesten Stand.

Zum Aktualisieren klickst du einfach auf den Button Update im Web-Interface der Firmware oder nutzt die Update-Liste in Home Assistant.

ESPHome CLI / Dashboard Vollständige Anpassung

Wenn du volle Kontrolle möchtest und eigene Sensoren, Automationen oder Funktionen hinzufügen willst, ist das der richtige Weg für dich — ideal für Power-User, die ihre Einrichtung komplett selbst gestalten wollen.

ESPHome Dashboard

Du kannst Doorman in dein ESPHome-Dashboard übernehmen und eine individuell angepasste Firmware flashen.

Die übernommene Konfiguration könnte zum Beispiel so aussehen:

yaml
# Doorman S3 Firmware
substitutions:
  name: "doorman-s3"
  friendly_name: "Doorman S3"

# Import Doorman Standard Firmware Config
packages:
  AzonInc.Doorman-Standard: github://azoninc/doorman/firmware/configurations/esp32-s3.ha.standard.master.yaml@master

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password

ESPHome CLI

Wenn du diese Option wählst, weißt du wahrscheinlich, was du tust – führe einfach den folgenden Befehl mit deiner YAML-Konfigurationsdatei aus.

Falls du lieber die reine MQTT-Firmware verwenden möchtest, kannst du einfach das unten bereitgestellte MQTT-Beispiel-YAML für dein Board übernehmen.

sh
esphome run <yamlfile.yaml>

Board Konfigurationsdateien

Standard GPIO Belegung

ComponentESP32-S3ESP32
TC:BUS RXGPIO 9GPIO 22
TC:BUS TXGPIO 8GPIO 23
Status LEDGPIO 1GPIO 2
RGB Status LEDGPIO 2GPIO 4
RelayGPIO 42GPIO 21
External ButtonGPIO 41GPIO 20
ADC InputGPIO 10GPIO 36

Standard Firmware

ESP32-S3 (Octal PSRAM) / Doorman S3 (1.5+)
yaml
# Doorman Standard Firmware (Home Assistant)
# Base Board ESP32-S3

# You can change a few options here.
substitutions:
  name: "doorman-s3"
  friendly_name: "Doorman S3"
  # led_pin: "GPIO1"
  # rgb_led_pin: "GPIO2"
  # relay_pin: "GPIO42"
  # external_button_pin: "GPIO41"
  # adc_input_pin: "GPIO10"

# Import Doorman Firmware Config
packages:
  AzonInc.Doorman-Standard: github://azoninc/doorman/firmware/configurations/esp32-s3.ha.standard.master.yaml@master

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password
yaml
# Doorman Standard Firmware (MQTT)
# Base Board ESP32-S3

# You can change a few options here.
substitutions:
  name: "doorman-s3"
  friendly_name: "Doorman S3"
  # led_pin: "GPIO1"
  # rgb_led_pin: "GPIO2"
  # relay_pin: "GPIO42"
  # external_button_pin: "GPIO41"
  # adc_input_pin: "GPIO10"

# Import Doorman Firmware Config
packages:
  AzonInc.Doorman-Standard: github://azoninc/doorman/firmware/configurations/esp32-s3.mqtt.standard.master.yaml@master

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password
yaml
# Doorman Standard Firmware (HomeKit)
# Base Board ESP32-S3

# You can change a few options here.
substitutions:
  name: "doorman-s3"
  friendly_name: "Doorman S3"
  # led_pin: "GPIO1"
  # rgb_led_pin: "GPIO2"
  # relay_pin: "GPIO42"
  # external_button_pin: "GPIO41"
  # adc_input_pin: "GPIO10"

# Import Doorman Firmware Config
packages:
  AzonInc.Doorman-Standard: github://azoninc/doorman/firmware/configurations/esp32-s3.homekit.standard.master.yaml@master

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password
yaml
# Doorman Standard Firmware (Custom)
# Base Board ESP32-S3

# You can change a few options here.
substitutions:
  name: "doorman-s3"
  friendly_name: "Doorman S3"
  # led_pin: "GPIO1"
  # rgb_led_pin: "GPIO2"
  # relay_pin: "GPIO42"
  # external_button_pin: "GPIO41"
  # adc_input_pin: "GPIO10"

# Import Doorman Firmware Config
packages:
  AzonInc.Doorman-Standard: github://azoninc/doorman/firmware/configurations/esp32-s3.custom.standard.master.yaml@master

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password
ESP32-S3 (Quad PSRAM) / Doorman S3 (1.4)
yaml
# Doorman Standard Firmware (Home Assistant)
# Base Board ESP32-S3-QUAD

# You can change a few options here.
substitutions:
  name: "doorman-s3"
  friendly_name: "Doorman S3"
  # led_pin: "GPIO1"
  # rgb_led_pin: "GPIO2"
  # relay_pin: "GPIO42"
  # external_button_pin: "GPIO41"
  # adc_input_pin: "GPIO10"

# Import Doorman Firmware Config
packages:
  AzonInc.Doorman-Standard: github://azoninc/doorman/firmware/configurations/esp32-s3-quad.ha.standard.master.yaml@master

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password
yaml
# Doorman Standard Firmware (MQTT)
# Base Board ESP32-S3-QUAD

# You can change a few options here.
substitutions:
  name: "doorman-s3"
  friendly_name: "Doorman S3"
  # led_pin: "GPIO1"
  # rgb_led_pin: "GPIO2"
  # relay_pin: "GPIO42"
  # external_button_pin: "GPIO41"
  # adc_input_pin: "GPIO10"

# Import Doorman Firmware Config
packages:
  AzonInc.Doorman-Standard: github://azoninc/doorman/firmware/configurations/esp32-s3-quad.mqtt.standard.master.yaml@master

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password
yaml
# Doorman Standard Firmware (HomeKit)
# Base Board ESP32-S3-QUAD

# You can change a few options here.
substitutions:
  name: "doorman-s3"
  friendly_name: "Doorman S3"
  # led_pin: "GPIO1"
  # rgb_led_pin: "GPIO2"
  # relay_pin: "GPIO42"
  # external_button_pin: "GPIO41"
  # adc_input_pin: "GPIO10"

# Import Doorman Firmware Config
packages:
  AzonInc.Doorman-Standard: github://azoninc/doorman/firmware/configurations/esp32-s3-quad.homekit.standard.master.yaml@master

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password
yaml
# Doorman Standard Firmware (Custom)
# Base Board ESP32-S3-QUAD

# You can change a few options here.
substitutions:
  name: "doorman-s3"
  friendly_name: "Doorman S3"
  # led_pin: "GPIO1"
  # rgb_led_pin: "GPIO2"
  # relay_pin: "GPIO42"
  # external_button_pin: "GPIO41"
  # adc_input_pin: "GPIO10"

# Import Doorman Firmware Config
packages:
  AzonInc.Doorman-Standard: github://azoninc/doorman/firmware/configurations/esp32-s3-quad.custom.standard.master.yaml@master

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password
Generic ESP32
yaml
# Doorman Standard Firmware (Home Assistant)
# Base Board ESP32

# You can change a few options here.
substitutions:
  name: "doorman-s3"
  friendly_name: "Doorman S3"
  # led_pin: "GPIO1"
  # rgb_led_pin: "GPIO2"
  # relay_pin: "GPIO42"
  # external_button_pin: "GPIO41"
  # adc_input_pin: "GPIO10"

# Import Doorman Firmware Config
packages:
  AzonInc.Doorman-Standard: github://azoninc/doorman/firmware/configurations/esp32.ha.standard.master.yaml@master

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password
yaml
# Doorman Standard Firmware (MQTT)
# Base Board ESP32

# You can change a few options here.
substitutions:
  name: "doorman-s3"
  friendly_name: "Doorman S3"
  # led_pin: "GPIO1"
  # rgb_led_pin: "GPIO2"
  # relay_pin: "GPIO42"
  # external_button_pin: "GPIO41"
  # adc_input_pin: "GPIO10"

# Import Doorman Firmware Config
packages:
  AzonInc.Doorman-Standard: github://azoninc/doorman/firmware/configurations/esp32.mqtt.standard.master.yaml@master

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password
yaml
# Doorman Standard Firmware (HomeKit)
# Base Board ESP32

# You can change a few options here.
substitutions:
  name: "doorman-s3"
  friendly_name: "Doorman S3"
  # led_pin: "GPIO1"
  # rgb_led_pin: "GPIO2"
  # relay_pin: "GPIO42"
  # external_button_pin: "GPIO41"
  # adc_input_pin: "GPIO10"

# Import Doorman Firmware Config
packages:
  AzonInc.Doorman-Standard: github://azoninc/doorman/firmware/configurations/esp32.homekit.standard.master.yaml@master

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password
yaml
# Doorman Standard Firmware (Custom)
# Base Board ESP32

# You can change a few options here.
substitutions:
  name: "doorman-s3"
  friendly_name: "Doorman S3"
  # led_pin: "GPIO1"
  # rgb_led_pin: "GPIO2"
  # relay_pin: "GPIO42"
  # external_button_pin: "GPIO41"
  # adc_input_pin: "GPIO10"

# Import Doorman Firmware Config
packages:
  AzonInc.Doorman-Standard: github://azoninc/doorman/firmware/configurations/esp32.custom.standard.master.yaml@master

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password

Nuki Bridge Firmware

ESP32-S3 (Octal PSRAM) / Doorman S3 (1.5+)
yaml
# Doorman Nuki Bridge Firmware (Home Assistant)
# Base Board ESP32-S3

# You can change a few options here.
substitutions:
  name: "doorman-s3"
  friendly_name: "Doorman S3"
  # led_pin: "GPIO1"
  # rgb_led_pin: "GPIO2"
  # relay_pin: "GPIO42"
  # external_button_pin: "GPIO41"
  # adc_input_pin: "GPIO10"

# Import Doorman Firmware Config
packages:
  AzonInc.Doorman-Nuki-Bridge: github://azoninc/doorman/firmware/configurations/esp32-s3.ha.nuki-bridge.master.yaml@master

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password
yaml
# Doorman Nuki Bridge Firmware (Custom)
# Base Board ESP32-S3

# You can change a few options here.
substitutions:
  name: "doorman-s3"
  friendly_name: "Doorman S3"
  # led_pin: "GPIO1"
  # rgb_led_pin: "GPIO2"
  # relay_pin: "GPIO42"
  # external_button_pin: "GPIO41"
  # adc_input_pin: "GPIO10"

# Import Doorman Firmware Config
packages:
  AzonInc.Doorman-Nuki-Bridge: github://azoninc/doorman/firmware/configurations/esp32-s3.custom.nuki-bridge.master.yaml@master

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password
ESP32-S3 (Quad PSRAM) / Doorman S3 (1.4)
yaml
# Doorman Nuki Bridge Firmware (Home Assistant)
# Base Board ESP32-S3-QUAD

# You can change a few options here.
substitutions:
  name: "doorman-s3"
  friendly_name: "Doorman S3"
  # led_pin: "GPIO1"
  # rgb_led_pin: "GPIO2"
  # relay_pin: "GPIO42"
  # external_button_pin: "GPIO41"
  # adc_input_pin: "GPIO10"

# Import Doorman Firmware Config
packages:
  AzonInc.Doorman-Nuki-Bridge: github://azoninc/doorman/firmware/configurations/esp32-s3-quad.ha.nuki-bridge.master.yaml@master

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password
yaml
# Doorman Nuki Bridge Firmware (Custom)
# Base Board ESP32-S3-QUAD

# You can change a few options here.
substitutions:
  name: "doorman-s3"
  friendly_name: "Doorman S3"
  # led_pin: "GPIO1"
  # rgb_led_pin: "GPIO2"
  # relay_pin: "GPIO42"
  # external_button_pin: "GPIO41"
  # adc_input_pin: "GPIO10"

# Import Doorman Firmware Config
packages:
  AzonInc.Doorman-Nuki-Bridge: github://azoninc/doorman/firmware/configurations/esp32-s3-quad.custom.nuki-bridge.master.yaml@master

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password
Generic ESP32
yaml
# Doorman Nuki Bridge Firmware (Home Assistant)
# Base Board ESP32

# You can change a few options here.
substitutions:
  name: "doorman-s3"
  friendly_name: "Doorman S3"
  # led_pin: "GPIO1"
  # rgb_led_pin: "GPIO2"
  # relay_pin: "GPIO42"
  # external_button_pin: "GPIO41"
  # adc_input_pin: "GPIO10"

# Import Doorman Firmware Config
packages:
  AzonInc.Doorman-Nuki-Bridge: github://azoninc/doorman/firmware/configurations/esp32.ha.nuki-bridge.master.yaml@master

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password
yaml
# Doorman Nuki Bridge Firmware (Custom)
# Base Board ESP32

# You can change a few options here.
substitutions:
  name: "doorman-s3"
  friendly_name: "Doorman S3"
  # led_pin: "GPIO1"
  # rgb_led_pin: "GPIO2"
  # relay_pin: "GPIO42"
  # external_button_pin: "GPIO41"
  # adc_input_pin: "GPIO10"

# Import Doorman Firmware Config
packages:
  AzonInc.Doorman-Nuki-Bridge: github://azoninc/doorman/firmware/configurations/esp32.custom.nuki-bridge.master.yaml@master

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password

Experimentelle Firmware

Du kannst auf den Entwicklungszweig wechseln, indem du die Option Experimental Firmware in der Doorman-Weboberfläche oder in Home Assistant aktivierst, um die neuesten Funktionen und Fehlerbehebungen zu nutzen.

HILFE GESUCHT

Bitte melde alle Probleme, die dir auffallen – dein Feedback hilft uns, die Stabilität zu verbessern und eine zuverlässige Firmware bereitzustellen.

Firmware Alternativen

Doorman Arduino Framework

Wenn du nach einer Firmware suchst, bei der du wirklich alles anpassen kannst wie du es magst, gibt es eine coole Alternative von @peteh. Schau sie dir auf GitHub an.

TIP

Diese Version eignet sich besonders für Entwickler oder fortgeschrittene Nutzer, die die Logik und das Verhalten ihres Doorman-Setups vollständig kontrollieren möchten.

Veröffentlicht unter der GPL 3.0 Lizenz.