Skip to content

Installation und Updates 2025.10.0-dev.310000

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 Install 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 Stock Firmware Config
packages:
  AzonInc.Doorman: github://azoninc/doorman/firmware/configurations/esp32-s3.ha.stock.dev.yaml@dev

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

Stock Firmware

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

# You can change a few options here.
substitutions:
  name: "doorman-s3"
  friendly_name: "Doorman S3"
  # log_level: "ERROR"
  # 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: github://azoninc/doorman/firmware/configurations/esp32-s3.ha.stock.dev.yaml@dev

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

# You can change a few options here.
substitutions:
  name: "doorman-s3"
  friendly_name: "Doorman S3"
  # log_level: "ERROR"
  # 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: github://azoninc/doorman/firmware/configurations/esp32-s3.mqtt.stock.dev.yaml@dev

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

# You can change a few options here.
substitutions:
  name: "doorman-s3"
  friendly_name: "Doorman S3"
  # log_level: "ERROR"
  # 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: github://azoninc/doorman/firmware/configurations/esp32-s3.homekit.stock.dev.yaml@dev

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

# You can change a few options here.
substitutions:
  name: "doorman-s3"
  friendly_name: "Doorman S3"
  # log_level: "ERROR"
  # 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: github://azoninc/doorman/firmware/configurations/esp32-s3.custom.stock.dev.yaml@dev

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

# You can change a few options here.
substitutions:
  name: "doorman-s3"
  friendly_name: "Doorman S3"
  # log_level: "ERROR"
  # 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: github://azoninc/doorman/firmware/configurations/esp32-s3-quad.ha.stock.dev.yaml@dev

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

# You can change a few options here.
substitutions:
  name: "doorman-s3"
  friendly_name: "Doorman S3"
  # log_level: "ERROR"
  # 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: github://azoninc/doorman/firmware/configurations/esp32-s3-quad.mqtt.stock.dev.yaml@dev

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

# You can change a few options here.
substitutions:
  name: "doorman-s3"
  friendly_name: "Doorman S3"
  # log_level: "ERROR"
  # 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: github://azoninc/doorman/firmware/configurations/esp32-s3-quad.homekit.stock.dev.yaml@dev

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

# You can change a few options here.
substitutions:
  name: "doorman-s3"
  friendly_name: "Doorman S3"
  # log_level: "ERROR"
  # 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: github://azoninc/doorman/firmware/configurations/esp32-s3-quad.custom.stock.dev.yaml@dev

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

# You can change a few options here.
substitutions:
  name: "doorman-s3"
  friendly_name: "Doorman S3"
  # log_level: "ERROR"
  # 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: github://azoninc/doorman/firmware/configurations/esp32.ha.stock.dev.yaml@dev

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

# You can change a few options here.
substitutions:
  name: "doorman-s3"
  friendly_name: "Doorman S3"
  # log_level: "ERROR"
  # 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: github://azoninc/doorman/firmware/configurations/esp32.mqtt.stock.dev.yaml@dev

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

# You can change a few options here.
substitutions:
  name: "doorman-s3"
  friendly_name: "Doorman S3"
  # log_level: "ERROR"
  # 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: github://azoninc/doorman/firmware/configurations/esp32.homekit.stock.dev.yaml@dev

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

# You can change a few options here.
substitutions:
  name: "doorman-s3"
  friendly_name: "Doorman S3"
  # log_level: "ERROR"
  # 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: github://azoninc/doorman/firmware/configurations/esp32.custom.stock.dev.yaml@dev

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"
  # log_level: "ERROR"
  # 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.dev.yaml@dev

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"
  # log_level: "ERROR"
  # 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.dev.yaml@dev

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"
  # log_level: "ERROR"
  # 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.dev.yaml@dev

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"
  # log_level: "ERROR"
  # 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.dev.yaml@dev

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"
  # log_level: "ERROR"
  # 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.dev.yaml@dev

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"
  # log_level: "ERROR"
  # 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.dev.yaml@dev

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

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.