Software Installation

BeagleBone shortcut is BBB.

  1. Connect BeagleBone to boneIO backplane and plug-in network cable.
  2. Find BBB in your network.
  3. Connect via ssh with username debian. Default password is temppwd.
  4. Change default password by running

Update your BBB

(click Yes if needed to perform upgrade). First upgrade can take ~30mins.

sudo apt-get update && sudo apt-get dist-upgrade
sudo reboot

Add uEnv to enable all possible PINS

Edit /boot/uEnv.txt and uncomment following lines (eg by using nano)


Disable unnecessary services

(if you need some you can just avoid disabling it).

sudo systemctl disable bonescript-autorun nginx wpa_supplicant bonescript.socket cloud9.socket
sudo reboot

Install dependencies

sudo apt-get install libopenjp2-7-dev libatlas-base-dev python3-venv libjpeg-dev zlib1g-dev

There are 2 ways to install BoneIO app.

Semi auto installation

Follow on screen instruction. If you read -devX version of the docs this way of installation won’t work!

bash -c "$(wget -qLO -"


Manual installation

Preffered way.

Let’s assume installing as default debian user in home directory and Python 3.7 as base.

Prepare VENV

export BONEIOPATH=~/boneio
python3 -m venv $BONEIOPATH/venv
source $BONEIOPATH/venv/bin/activate
pip3 install --upgrade pip
pip3 install boneIO==0.6.0
cp $BONEIOPATH/venv/lib/python3.7/site-packages/boneio/example_config/*.yaml $BONEIOPATH/

Now edit ~/boneio/config.yaml

Run manually with debug flag

# export BONEIOPATH=~/boneio
source ~/boneio/venv/bin/activate
boneio run -c ~/boneio/config.yaml -dd

Create startup script

Create file `~/boneio/boneio.service


ExecStart=/home/debian/boneio/venv/bin/boneio run -c /home/debian/boneio/config.yaml


Copy file to systemd and enable it.

sudo cp ~/boneio/boneio.service /lib/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now boneio