Setup Cyclops

In this step, we install Cyclops on the raspberry pi.

Before you start, make sure to have:

• MAVLink device port and baudrate

• Storage device

• Theseus account email and password for license activation

If you're missing any of this you can come back later and edit your configuration.

Run this command to get started:

# download and install Cyclops
curl -fsSL https://packages.theseus.us/install.sh | sudo bash

This script installs all Cyclops dependencies as well as data and packages for Cyclops on your device. You will see this if things are working as expected:

pi@dronepi:~$ curl -fsSL https://packages.theseus.us/install.sh | sudo bash

========================================
  Theseus Cyclops Installation Script
========================================

[OK] Architecture: arm64
[OK] Ubuntu version: 24.04 (Noble)
[INFO] Adding Theseus APT repository...
[INFO] Downloading GPG key...
File '/usr/share/keyrings/theseus.gpg' exists. Overwrite? (y/N) y
[OK] GPG key installed
[INFO] Adding repository to sources.list.d...
[OK] Repository added: /etc/apt/sources.list.d/theseus.list
[INFO] Updating package lists...
[INFO] Installing cyclops and vns-sdk-data (this may take a few minutes)...
Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
cyclops is already the newest version (1.12.0+dev.d6faa68).
vns-sdk-data is already the newest version (1.1.0).
0 upgraded, 0 newly installed, 0 to remove and 148 not upgraded.
[OK] Packages installed successfully!

[INFO] Installed version:
Cyclops
==================

Version:          1.12.0+dev.d6faa68
Git Branch:       dev
Git Commit:       d6faa68
Build Timestamp:  2026-01-13 22:54:32 UTC

Build Configuration
-------------------

You will then be prompted to configure your device (MAVProxy and storage). Enter y to proceed.

Would you like to configure your device now? (y/N): y

Enter recordings directory path (e.g., /mnt/nvme) [skip]: /mnt/t9
Set paths.recordings_dir = /mnt/t9
[OK] Recordings path set to: /mnt/t9
Enter MAVProxy serial device (e.g., /dev/ttyS4) [skip]: /dev/ttyS4
Enter baud rate [921600]: 
Device /dev/ttyS4 already exists, updating baudrate to 921600
[OK] Added MAVProxy device: /dev/ttyS4 @ 921600

NOTE: Our baudrate differs from the default baudrate.The waveshare hat struggles at higher baud rates. Ensure your serial baud rate matches

We added both serial devices, so either port on our serial hat will work for mavlink

Next, the script will prompt you to activate your Cyclops license. You receive two licenses when creating your Theseus account.

========================================
  License Activation
========================================

License activation requires a Theseus account.
If you don't have one, visit: https://docs.theseus.us

Would you like to activate your license now? (y/N): 
[INFO] Skipping license activation.
[INFO] You can activate later by running:
  cyclops_exe --activate-license

You can come back to activate your license later by running cyclops_exe --activate-license.

You should see the following message once you've gone through all the installation steps:

========================================
  Installation Complete
========================================

[OK] Cyclops has been installed!

Useful commands:
  vns-config show                    # View current configuration
  vns-config set recordings /mnt/ssd # Set recordings directory
  cyclops_exe --license-info         # View license status
  cyclops_exe --activate-license     # Activate license
  sudo systemctl start cyclops       # Start Cyclops service

Documentation: https://docs.theseus.us
Support: [email protected]

Reboot the device