BerryLan

an open source tool by nymea

  • How does BerryLan work?

    If the Raspberry Pi does not have any network connection, it starts a Bluetooth Server. The app discovers that Bluetooth Signal, and connects to it. Then, the Raspberry Pi sends over all the WiFi networks it can currently connect to. The user chooses the WiFi he wants to connect to and enters the password for it. If the connection is successful, the user will see the IP address of the Raspberry Pi and the Bluetooth server will stop broadcasting.

  • Why does the app ask for permission to access my location?

    The app uses your phone’s Bluetooth for the setup process. Bluetooth can be used to determine your position. BerryLan does not record or send any position data.

  • I can't find any BerryLans

    • The booting process of the Raspberry Pi takes some time, please be patient.
    • The BerryLan App requires access to your phone's Bluetooth to do it's magic. Your phone will ask about permissions to use the localisation service. Make sure you authorise it.
    • The Raspberry Pi is already connected to a LAN or WiFi.
    • You need to be near the Raspberry Pi that you want to setup.
    • Make sure you have a Raspberry Pi 3 or a Raspberry Pi Zero W (the other models look pretty similar)
  • I can't find the WiFi network I want to connect to

    • The WiFi signal may be too weak.
    • The WiFi technology might not be supported by the Raspberry Pi. Currenty supported WiFi b/g/n (2,4GHz) with WPE, WPA, WPA2 encryption.
  • Does it have to be Raspberry? Can BerryLan be installed on any alternative hardware?

    It's likely! Give it a try! We made it for Raspberry Pi, but we will definitely help you if you have a cool idea!

  • How can I use BerryLan on my already existing Raspbian image?

    You would need to install the BerryLan networkmanager and restart the Raspberry Pi.

    1. Add the nymea repository to your system:

      pi:~$echo "deb http://repository.nymea.io stretch main raspbian" | sudo tee /etc/apt/sources.list.d/nymea.list
      pi:~$sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-key A1A19ED6
    2. Configure apt to prefere packages from the raspbian section of the repository

      Note: the Raspberry Pi Zero W requires packages from the raspbian section, since they are not plain armhf, but specially built for all Raspberry Pi versions. If you are on Raspberry Pi 2/3 you can skip this step.

      pi:~$nano /etc/apt/preferences.d/nymea
    3. Add following lines to the file:

      Package: *
      Pin: release c=raspbian
      Pin-Priority: 700
      
      Package: *
      Pin: origin repository.nymea.io c=main
      Pin-Priority: 500
    4. Install the dependencies:

      pi:~$sudo apt-get update
      pi:~$sudo apt-get install nymea-networkmanager dirmngr
    5. Disable dhcpcd:

      pi:~$sudo systemctl disable dhcpcd
      pi:~$reboot
  • The Raspberry Pi doesn't connect to the WiFi

    The WiFi signal may be too weak.

  • I get a "password is wrong" when I try to login

    Make sure you check your caps lock, or just press the "eye" next to the input field and check carefully if it is the correct password.