Voraussetzungen
Du benötigst einen Computer, eine passende SD-Karte für deinen Raspberry Pi mit dem richtigen Betriebssystem (Glossar)Die grundlegende Software, die einen Computer verwaltet — z. B. Windows, macOS, Linux oder Raspberry Pi OS. (siehe SD-Karte einrichten) sowie eine Internetverbindung.
BirdNET Pi installieren
-
Stecke die SD-Karte in den Raspberry Pi.
-
Schließe den Raspberry Pi mithilfe des Netzteils an den Strom an. Es sollte eine LED am Raspberry Pi leuchten oder blinken. Warte am besten ein paar Minuten, damit er hochfahren kann.
-
Öffne die Konsole (Glossar)Textbasierte Oberfläche, über die du Befehle direkt an das Betriebssystem sendest — auch Kommandozeile oder Terminal genannt. .
- Verbinde dich mit dem Pi über das folgende Kommando. Nutze dazu die von dir zuvor eingegebenen Daten.
ssh birder@birdnetpi.localPS C:\Users\Name> ssh birder@birdnetpi.local
The authenticity of host 'birdnetpi.local (2a02:4454:c122:2000:15gc:24b7:f06a:f322)' can't be established.
ED25519 key fingerprint is SHA256:kfRttaVIh+Z/FbSq9g6adalVfIsgvUtk4o.
This key is not known by any other names.
Are you sure you want to continue connecting (yes/no/[fingerprint])? Wenn die Meldung erscheint:
PS C:\Users\Name> ssh birder@birdnetpi.local
ssh: Could not resolve hostname birdnetpi.local: Der angegebene Host ist unbekannt. bedeutet das, dass keine Verbindung zu deinem Raspberry Pi hergestellt werden kann.
Überprüfe folgende Punkte:
- Stromversorgung: Stelle sicher, dass der Raspberry Pi eingeschaltet ist, die SD-Karte korrekt eingesteckt ist und die Status-LEDs blinken oder leuchten.
- Netzwerk: Vergewissere dich, dass PC und Raspberry Pi im selben Netzwerk sind - also mit demselben WLAN oder Hotspot verbunden. (Achte darauf, dass die WLAN-Daten im Raspberry Pi OS mit deinem aktuellen WLAN übereinstimmen.)
- Neuinstallation: Wenn die Verbindung weiterhin fehlschlägt, installiere Raspberry Pi OS neu auf der SD-Karte und trage die WLAN-Zugangsdaten erneut sorgfältig ein.
- Direkte Verbindung: Erfahrene Nutzer können eine Tastatur und einen Bildschirm direkt am Raspberry Pi anschließen, um die Verbindung und Netzwerkeinstellungen manuell zu Überprüfen.
Keine Sorge, das ist normal, wenn du bereits früher per SSH mit einem Raspberry Pi gleichen Namens verbunden warst. So behebst du das Problem:
- Öffne die Datei: C:\Users\Benutzername.ssh\known_hosts (der genaue Pfad steht auch in der Warnung) mit einem Texteditor.
- Suche alle Zeilen, die mit birdnetpi.local beginnen, und lösche sie. Es können mehrere Einträge sein, die sich über mehrere Zeilen erstrecken.
- Wenn du SSH noch nie für andere Verbindungen genutzt hast, kannst du auch den gesamten Inhalt der Datei löschen.
- Speichere die Datei, schließe den Editor und versuche die Verbindung anschließend erneut.
- Bestätige die Verbindung.
yesAre you sure you want to continue connecting (yes/no/[fingerprint])? yes
Warning: Permanently added 'birdnetpi.local' (ED25529) to the list of known hosts.
Connection closed by 2a02:4454:c122:2000:15gc:24b7:f06a:f322 port 23
birder@birdnetpi.local's password: - Daraufhin sollte eine Passworteingabe erscheinen. Gib das im Betriebssystem gespeicherte Passwort ein. Beachte, dass die Eingabe dabei unsichtbar bleibt. Wenn du nicht mehr zur Eingabe eines Passworts aufgefordert wirst, starte den Vorgang erneut, indem du den Befehl aus Schritt 4 eingibst.
birder@birdnetpi.local's password:
Linux birdnetpi 6.12.47+rpt-rpi-v8 #1 SMP PREEMPT Debian 1:6.12.47-1+rpt1~bookworm (2025-09-01) aarch64
The programs included with the Debian GNU/Linux system are free software;
the exact distribution terms for each program are described in the
individual files in /usr/share/doc/\*/copyright.
Debian GNU/Linux comes with ABSOLUTELY NO WARRANTY, to the extent
permitted by applicable law.
Last login: Thu Oct 01 00:00:00 2025 from 2a02:4454:c122:2000:15gc:24b7:f06a:f322 -
Dieser Schritt ist nur für den Raspberry Pi Zero 2 W:
Der Arbeitsspeicher des Raspberry Pi Zero 2 W ist zu gering, um BirdNET-Pi ohne Anpassung zu installieren. Daher muss die sogenannte Swapsize erhöht werden. Sie sorgt dafür, dass zusätzlich zur physischen Hardware auch ein Teil der SD-Karte als Arbeitsspeicher genutzt wird. Ohne diese Anpassung lässt sich BirdNET-Pi auf dem Zero 2 W nicht installieren. Zudem müssen die WLAN-Energieoptionen angepasst werden.
sudo sed -i 's/CONF_SWAPSIZE=512/CONF_SWAPSIZE=2048/g' /etc/dphys-swapfile &&
sudo sed -i 's/#CONF_MAXSWAP=2048/CONF_MAXSWAP=4096/g' /etc/dphys-swapfile &&
sudo sed -i '/^exit 0/i sudo iw wlan0 set power_save off' /etc/rc.localSollte die Insallation von BirdNET-Pi auf deinem Raspberry Pi Zero 2 W fehlschlagen, könnte es daran liegen, dass die Einstellungen nicht richtig übernommen wurden. Überprüfe in diesem Fall die folgenden Punkte, um sicherzustellen, dass die Anpassungen korrekt vorgenommen wurden.
Um sicherzustellen, dass die Änderungen tatsächlich angewendet wurden, kannst du die passende Datei mit dem folgenden Befehl öffnen.
sudo nano /etc/dphys-swapfileWichtig ist, dass die Zeilen CONF_SWAPSIZE=2048 und CONF_MAXSWAP=4096 stimmen. Falls nicht, passe die Zahlen an.
GNU nano 7.2 /etc/dphys-swapfile # /etc/dphys-swapfile - user settings for dphys-swapfile package
# author Neil Franklin, last modification 2010.05.05
# copyright ETH Zuerich Physics Departement
# use under either modified/non-advertising BSD or GPL license
# this file is sourced with . so full normal sh syntax applies
# the default settings are added as commented out CONF\__=_ lines
# where we want the swapfile to be, this is the default
#CONF_SWAPFILE=/var/swap
# set size to absolute value, leaving empty (default) then uses computed value# you most likely don't want this, unless you have an special disk situation
CONF_SWAPSIZE=2048
# set size to computed value, this times RAM size, dynamically adapts,
# guarantees that there is enough swap without wasting disk space on excess
#CONF_SWAPFACTOR=2
# restrict size (computed and absolute!) to maximally this limit
# can be set to empty for no limit, but beware of filled partitions!
# this is/was a (outdated?) 32bit kernel limit (in MBytes), do not overrun ># but is also sensible on 64bit to prevent filling /var or even / partition
CONF_MAXSWAP=4096
[ Read 26 lines ]
^G Help ^O Write Out ^W Where Is ^K Cut ^T Execute
^X Exit ^R Read File ^\ Replace ^U Paste ^J Justify Drücke Strg+x, dann y, abschließend Enter, um die Datei zu speichern.
- Um sicherzustellen, dass die Änderungen tatsächlich angewendet wurden, kannst du die passende Datei mit dem folgenden Befehl öffnen.
sudo nano /etc/rc.local GNU nano 7.2 /etc/rc.local
[ New File ]
^G Help ^O Write Out ^W Where Is ^K Cut ^T Execute
^X Exit ^R Read File ^\ Replace ^U Paste ^J Justify Sollte die Datei leer sein, führe die weiteren Schritte aus. Sollte sie hingegen wie im folgenden Schritt zwei aussehen, kannst du die Datei wieder schließen.
- Füge folgenden Inhalt ein:
#!/bin/bash
sudo iw wlan0 set power_save off
exit 0 GNU nano 7.2 /etc/rc.local
#!/bin/bash
sudo iw wlan0 set power_save off
exit 0
[ New File ]
^G Help ^O Write Out ^W Where Is ^K Cut ^T Execute
^X Exit ^R Read File ^\ Replace ^U Paste ^J Justify - Drücken Strg+x, dann y, abschließend Enter, um die Datei zu speichern.
Starte den Raspberry Pi jetzt neu.
sudo rebootWarte anschließend einige Minuten, bis das System vollständig gestartet ist und sich mit dem WLAN verbunden hat. Verbinde dich danach erneut per SSH mit dem Pi (siehe Schritt 4 und 6).
- Mit diesem Befehl startest du die Installation von BirdNET-Pi. Der Vorgang kann mehrere Minuten dauern - je nach Internetverbindung und Systemleistung. Lass das Terminal geöffnet, bis die Installation vollständig abgeschlossen ist.
curl -s https://raw.githubusercontent.com/Nachtzuster/BirdNET-Pi/main/newinstaller.sh | bash