Skip to content

ServoBox Run Guide

Get up and running with a real-time VM, verify performance, set up networking, and install control stacks. For in-depth options, follow the links to the User Guide.

1) Create your first RT VM

servobox init
  • Defaults: name servobox-vm, 4 vCPUs, 8GB RAM, 40GB disk, NAT 192.168.122.100.
  • First run downloads the base image (cached afterwards).

Start it:

servobox start

2) Verify RT configuration and latency

servobox rt-verify          # Check pinning, IRQs, kernel params
servobox test --duration 30 # Quick cyclictest

3) Networking

Configure or change networking after creation:

servobox network-setup  # Interactive NIC wizard

4) Install packages and run stacks

The package installer adds pre-configured robotics stacks into your VM image and resolves dependencies automatically.

Basics:

# Discover packages
servobox pkg-install --list

# Install a stack (deps auto-installed)
servobox pkg-install serl-franka-controllers

# Run a stack's launch helper
servobox run serl-franka-controllers

# Target a specific VM
servobox pkg-install --name my-vm libfranka-gen1

# Use custom/local recipes
servobox pkg-install --custom ~/my-recipes my-package

# Show detailed progress
servobox pkg-install ros2-humble --verbose

5) SSH access

servobox ssh --name my-vm

SSH details are covered in the Network Configuration guide.

Troubleshooting