Update via SSH

This guide describes manual controller update via SSH. It's useful when:

• You want to install a specific software version
• The web interface update doesn't work
• You need more control over the update process

Requirements

• SSH connection to the controller (see SSH connection guide)
• Internet access on the controller

Update process

Step 1: Stop the boneIO service

sudo systemctl stop boneio

Enter the password (default temppwd).

Step 2: Activate the virtual environment

source ~/boneio/venv/bin/activate

Step 3: Update pip

pip3 install --upgrade pip

Step 4: Update boneIO

pip3 install --upgrade boneio

Step 5: Start the boneIO service

sudo systemctl start boneio

Simplified version

You can execute all commands in three sequences:

sudo systemctl stop boneio

source ~/boneio/venv/bin/activate && pip3 install --upgrade pip && pip3 install --upgrade boneio

sudo systemctl start boneio

Installing a specific version

To install a specific version:

pip3 install boneio==1.0.0

Replace 1.0.0 with the desired version.

Checking the version

To check the currently installed version:

pip3 show boneio | grep Version

Important changes

When introducing important changes to the application, we always inform about them in the release notes. Please read this information carefully before updating.

Troubleshooting

Error during pip installation

If you get an error related to pip, try:

python3 -m pip install --upgrade pip

Application doesn't start after update

Check the logs:

journalctl -u boneio -f

If there are configuration errors, you may need to adjust the config.yaml file for the new version.