Skip to content

Installation Guide

ehpersonal38 edited this page Jul 13, 2022 · 12 revisions
  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 birder@birdnetpi1.local

  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 | 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.