YoovoConnect

The companion app for yoovo.io that runs on your Raspberry Pi. It bridges the Yoovo cloud platform to your physical hardware — letting you deploy visual projects, manage libraries, and control your Pi from anywhere.

Supported Devices

YoovoConnect supports 64-bit (arm64) operating systems. We recommend using the latest 64-bit version of Raspberry Pi OS.

System Requirements

Installation

Step 1 — Download the .deb package

Download the YoovoConnect .deb package from yoovo.io/connect. Choose the version that matches your Raspberry Pi OS:

• Bookworm (Debian 12) — Recommended
• Trixie (Debian 13)

Step 2 — Transfer to your Raspberry Pi

Copy the downloaded .deb file to your Pi using a USB drive, direct browser download, or SCP over the network:

scp yoovo-connect_<version>_arm64.deb pi@<your-pi-ip>:~/

Step 3 — Install the package

Open a terminal on your Pi, navigate to the folder containing the file, and run:

sudo apt install ./yoovo-connect_<version>_arm64.deb

What happens during installation

The installer automatically:

• Installs YoovoConnect binaries to /opt/yoovo/
• Creates the yoovo system user with appropriate permissions
• Installs Python 3.9 if not already present
• Sets up required Python libraries
• Creates and starts two background services (yoovo-agent and yoovo-api)
• Adds a desktop shortcut and system tray icon (on desktop environments)
• Initializes the local database

Once installation completes, the dashboard is immediately accessible.

First Launch

Accessing the dashboard

After installation, open a browser and navigate to:

http://localhost:4200

Or from another device on the same network:

http://<your-pi-ip-address>:4200

Signing in

On first launch you'll be directed to the sign-in page. You can sign in using:

• Google Sign-In — Click the Google button to authenticate with your Google account linked to Yoovo
• Email & Password — Enter your Yoovo account credentials

You must have an existing account on yoovo.io. If you don't have one, create a free account first.

Device registration

After signing in, you'll be prompted to register your device:

Dashboard — Overview

The Overview tab gives you a real-time snapshot of your Pi's health and identity. The dashboard has four main sections accessible via the top navigation tabs.

System health

Device information

Dashboard — Projects

The Projects tab lets you manage all deployed projects on your Pi. Each project shows its name, status, version, last deployment date, and available actions.

Project statuses

Available actions

• Start — Run the project
• Stop — Terminate a running project
• Delete — Remove the project from the Pi
• View Logs — See project output and error logs
• Set as Default — Mark a project to auto-run on boot

Dashboard — Libraries

The Libraries tab manages Python packages installed on your Pi. Each package shows its name, version, and current status.

Package statuses

Actions

• Install — Add a new Python package
• Uninstall — Remove a package
• Sync — Synchronize libraries with the cloud server
• Create Snapshot — Save the current package state for rollback
• Restore Snapshot — Roll back to a previously saved state

Dashboard — Settings

General

• Device Alias — Change your Pi's display name
• Auto-start Agent — Start YoovoConnect automatically on boot
• Auto-start Default Project — Automatically run the default project on boot
• Version Info — View the installed version and check for updates

Security

• Account Info — View the signed-in user account
• Sign Out — Unbind this Pi from your Yoovo account
• Device Binding Status — Verify the connection to the cloud

Working with Projects

How projects work

Project structure

Projects deployed to YoovoConnect must include the following:

Run history

Each project maintains a run history showing start and stop timestamps, duration, exit code, and output logs.

Library Management

YoovoConnect manages Python packages through pip with additional cloud synchronization.

Library snapshots

Snapshots let you save and restore the exact state of all installed packages. This is especially useful in classroom settings where consistent environments across multiple Pis are needed.

Cloud sync

YoovoConnect periodically syncs with the Yoovo cloud to ensure required libraries are installed. The sync process checks which libraries are needed for your projects, installs missing packages automatically, and uses optimized package repositories for Raspberry Pi.

Updates

YoovoConnect checks for updates periodically in the background. When a new version is available, a notification appears in the dashboard. You can then download and apply the update with one click — services restart automatically with your data and configuration preserved.

Manual update

You can also update manually by downloading the latest .deb from yoovo.io/connect and running:

sudo apt install ./yoovo-connect_<new-version>_arm64.deb

Architecture & Services

YoovoConnect runs as two background services managed by systemd:

Service management

# Check status
sudo systemctl status yoovo-agent
sudo systemctl status yoovo-api

# Restart
sudo systemctl restart yoovo-agent
sudo systemctl restart yoovo-api

# View live logs
journalctl -u yoovo-agent -f
journalctl -u yoovo-api -f

File locations

Troubleshooting

Dashboard not loading

Check that the API service is running:

sudo systemctl status yoovo-api

If stopped, start it:

sudo systemctl start yoovo-api

Verify the port is accessible:

curl http://localhost:4200

Device not appearing in Yoovo cloud

Check the agent service and verify internet connectivity:

sudo systemctl status yoovo-agent

Inspect the agent logs for connection errors:

tail -50 /opt/yoovo/data/logs/agent-service.log

Projects won't start

• Verify the project has a valid main.py entry point
• Check project logs from the dashboard for error details
• Ensure all required libraries are installed (Libraries tab)
• Verify sufficient disk space: df -h

Sign-in issues

• Ensure your Pi has internet access
• Clear the browser cache and try again
• Confirm your Yoovo account exists at yoovo.io

Services won't start after reboot

Re-enable and start the services:

sudo systemctl enable yoovo-agent yoovo-api
sudo systemctl start yoovo-agent yoovo-api

Uninstalling

To remove YoovoConnect while keeping your data:

sudo apt remove yoovo-connect

To remove YoovoConnect and all associated data (binaries, config, database, downloaded projects):

sudo apt purge yoovo-connect