Installation Guide

1. Open the Raspberry Pi Imager and click "CHOOSE OS" to select the operating system BirdNET-Pi will use
   
   
2. Click "Raspberry Pi OS (other) Other Raspberry Pi OS based images"
   
   
3. Scroll down the list and select "Raspberry Pi OS Lite (64-bit)"
   
   
4. Next, click "CHOOSE STORAGE" to select the SD card the BirdNET-Pi will use
   
   
5. Choose the SD card onto which we will write the RaspiOS-Lite (64-bit) operating system
   
   
6. Now, click the gear icon in the bottom right to open the "Advanced options" menu
   
   
7. Set the hostname you would like this BirdNET-Pi to use to be reached. For example,
   to have multiple BirdNET-Pis on the same network, you might want to give them each a different
   hostname. In this example, the installation will be reachable at "http://birdnetpi1.local",
   since that is the hostname that is set during this step. Keeping this unset (using the default
   raspberrypi hostname), the installation will default to being reachable at "http://birdnetpi.local".
   You should also "Enable SSH" and select to "Use password authentication"
   
8. When you scroll down, you will set the option to "Set username and password." This example creates
   a new user called birder. You will also configure the system's connection to your WiFi by
   entering the network's name (SSID) and the password used to connect to that WiFi.
   
   
9. Adjust the locale settings for your Time zone and Keyboard layout
   
   
10. Finally, you can save the settings and click "WRITE" to write the image to the SD card
    Select "YES" and enter to allow your host system (the computer you're on now) to write the SD card.
    
    
11. Wait while the image is written to the card and the checksums verified
    
    
    
    
    
    
12. When the SD card is ready, you'll be notified that is ok to remove it from your computer
    
    
13. At this point, you will put the SD card into the Raspberry Pi and will allow it a few minutes to
    boot up. After a few minutes, you can move on to the next step.
    
14. Using a terminal emulator of your choosing (macOS and Linux users can use the terminals that
    come with the OS -- Windows users can use PowerShell or PuTTY).
    
15. Use the username and hostname from step 8 to SSH into the Raspberry Pi
    In this example, we created the birder user on the birdnetpi1.local host, so the command would be
    ssh [email protected]
    
    
16. When warned that you are connecting to a new machine, type yes to proceed
    
    
    
17. You will be prompted for the password that you set in step 8
    
    
18. After entering the password for your user, you will be able to begin the installation!
    
    
19. Copy and paste the command below into the terminal and press "Enter"
    Note: Ctrl+Shift+V will often paste in Terminals -- in PuTTY, right-click to paste
    

    curl -s https://raw.githubusercontent.com/mcguirepr89/BirdNET-Pi/main/newinstaller.sh | bash
    

    
    
20. Then, the installation will run and may take a little while, so just be patient.
    
    
21. When the installation is finished, the system will automatically reboot. When it is booted back up,
    you will be able to reach your BirdNET-Pi using the hostname you set in step 8. In this
    installation example, it is http://birdnetpi1.local. The default (if you did not set a specific hostname
    in step 8) will be http://birdnetpi.local. It can also be reached at the Pi's IP address.
    
    Note: Don't worry that things look weird at first, the system is just hungry for data.
    
    
22. To finalize your installation, you'll want to double-check the Latitude and Longitude that were
    auto-discovered during installation to be sure that they represent the location you will be using.
    To do this, click "Tools" in the top right corner.
    
23. You will be prompted for a username and password to reach the "Tools" page. The default username
    is birdnet and, by default, there is no password, so leave that empty.
    
    
24. On the "Tools" page, click the "Settings" button on the far left.
    
    
25. Adjust your Latitude and Longitude if you need to. Click "Update Settings" when those values are
    accurate. You can also request a BirdWeather ID from here, and can check out the "Advanced Settings"
    in case there are other settings you are interested in adjusting.
    

HAPPY BIRDING!!!