Skip to main content

​
Installation

Get the Device Manager running on your robot in just a few steps.

​
Prerequisites

  • Ubuntu 18.04+ or Raspberry Pi OS (x86_64 or ARM64)
  • Root access for installation
  • Outbound internet connectivity
  • Device capsule from your Roboticks dashboard

​
Quick Install

1

Download the Manager

curl -L -o roboticks-manager.tar.gz \
  "https://releases.roboticks.io/manager/latest/roboticks-manager-$(uname -m).tar.gz"

sudo tar -xzf roboticks-manager.tar.gz -C /opt/
2

Apply Your Capsule

The capsule contains your device’s credentials. Download it from the Roboticks dashboard.
sudo tar -xzf device-capsule.tar.gz -C /opt/roboticks-manager/
3

Start the Service

sudo /opt/roboticks-manager/install.sh
sudo systemctl start roboticks-manager
4

Verify Connection

Your device should appear in the Roboticks dashboard within 30 seconds.
sudo systemctl status roboticks-manager

​
Alternative: Docker

If you prefer Docker: 
docker run -d \
  --name roboticks-manager \
  --restart unless-stopped \
  --privileged \
  -v /opt/roboticks:/opt/roboticks \
  -v /var/roboticks:/var/roboticks \
  -v ./device-capsule:/capsule:ro \
  roboticks/device-manager:latest
Or with Docker Compose: 
services:
  device-manager:
    image: roboticks/device-manager:latest
    restart: unless-stopped
    privileged: true
    volumes:
      - /opt/roboticks:/opt/roboticks
      - /var/roboticks:/var/roboticks
      - ./device-capsule:/capsule:ro

​
What the Capsule Contains

Your device capsule is a secure package containing:
  • Device configuration - Pre-configured for your organization
  • Credentials - Secure certificates for cloud authentication
  • Device ID - Unique identifier for your device
Keep capsules secure. They contain credentials that grant access to your Roboticks organization.

​
Verify Installation

After starting the service:
  1. Check the service is running: 
    sudo systemctl status roboticks-manager
  2. View the device in dashboard: Navigate to Fleet in your Roboticks dashboard - the device should appear within 30 seconds.
  3. Check logs if needed: 
    sudo journalctl -u roboticks-manager -f

​
Network Requirements

The Device Manager needs outbound HTTPS access (port 443). No incoming ports need to be opened.
All connections are initiated by the device - your firewall doesn’t need any special configuration for incoming traffic.

​
Troubleshooting

  1. Check the manager is running: sudo systemctl status roboticks-manager
  2. Verify network connectivity: curl -I https://api.roboticks.io
  3. Check logs: sudo journalctl -u roboticks-manager -n 50
  • Verify outbound port 443 is open
  • Check DNS resolution works
  • Ensure system time is accurate (use NTP)
  • Verify capsule hasn’t expired (re-download from dashboard)
  • Check config file exists: ls /opt/roboticks-manager/config/
  • Verify capsule was extracted correctly
  • Check file permissions: ls -la /opt/roboticks-manager/

​
Next Steps

First Session

Start your first session

ROS2 Integration

Connect your ROS2 applications