Skip to main content
Version: 0.4.x

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

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

Install dependencies

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

There are 2 ways to install BoneIO app.

Semi auto installation

Follow on screen instruction.

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

mkdir ~/boneio
python3 -m venv ~/boneio/venv
source ~/boneio/venv/bin/activate
pip3 install --upgrade boneio
cp ~/venv/lib/python3.7/site-packages/boneio/example_config/*.yaml ~/boneio/

Now edit ~/boneio/config.yaml

Run manually with debug flag

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