There are two ways to install BerryNet:
- Install from pre-built image
- Install from source
If the reference command listed below starts with
host: it means you should do it on the host machine (a Linux PC is preferred).
rpi: it means you should do it on Raspberry Pi.
Install From Pre-Built Image
Assuming that the image is saved to
host $ md5sum /home/DT42/Downloads/2019-07-15-raspbian-buster-berrynet.zip 8bda8053a69995814a0ca6fa60b1d49e 2019-07-15-raspbian-buster-berrynet.zip
You can get older releases from prior release notes
Write image to SD card
Assuming that the inserted SD card is represented as
/dev/sdbon system. (If you see other similar device notes like
/dev/sdb2, you can ignore them without causing any problem.)
host $ unzip -p 2019-07-15-raspbian-buster-berrynet.zip | sudo dd of=/dev/sdb bs=4M conv=fsync status=progress
Your SD card size has to be >= 8GB.
Boot RPi with the SD card, and login.
- Connect keyboard, mouse, and monitor to RPi.
- Insert SD card to RPi.
- Connect camera to RPi.
- Connect power adapter to RPi.
Login, the default user name and password are
(Optional) Setup Wifi, if you plan to use Wifi to send out inference results or if you plan check the dashboard from another machine instead of connecting the monitor directly to Raspberry Pi.
Click the network icon at top-right of desktop, and select your country code and Wifi AP.
(Optional) Resize filesystem size manually, if your SD card size is > 8GB and want to use its all storage
rpi $ sudo raspi-config
and choose "Advanced Options" -> "Expend Filesystem".
(Optional) Update to the latest BerryNet
The default BerryNet in the image is verified. If you are interested in the latest features, you can update BerryNet by executing the commands:
rpi $ sudo apt update rpi $ sudo apt install -y berrynet
Reboot RPi and login again.
- BerryNet default detection application is running in background after booting.
Install From Source
Before BerryNet installation, please creating a system SD card by following the RPi official installation guide.
Here are the steps to install BerryNet on RPi:
Get BerryNet source codes
rpi $ git clone https://github.com/DT42/BerryNet.git rpi $ cd BerryNet
Execute installation script
rpi $ ./configure
The installation will take a while.
If the installation is completed successfully, next step is to configure your BerryNet.
If the installation fails, you can
- Check is it an known issue
- Create an issue report and attach
- Share the problem with the community
and we will try our best to check it.
All the Raspbian images is available on https://downloads.raspberrypi.org/
BerryNet releases base
- v3.7.0: 2019-07-10 buster
- v3.5.1: 2019-04-08 stretch
In The Future
We are packaging BerryNet and its dependencies to be Debian packages. The long-term goal is to make all the packages followed Debian policy can be available in Debian by default.