Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.roboticks.io/llms.txt

Use this file to discover all available pages before exploring further.

​
Frequently Asked Questions

Common questions about using Roboticks for robot fleet management.

​
Getting Started

Roboticks is a cloud platform for managing robot fleets at scale. It provides tools for monitoring device health, streaming logs, deploying software, and remotely accessing robots. It integrates with ROS2 but works with any Linux-based device.
No. Your ROS2 nodes run unchanged. Roboticks wraps your existing applications and manages their lifecycle, logging, and deployment without requiring code changes.
Roboticks supports any Linux device with outbound internet access:
  • Ubuntu 18.04, 20.04, 22.04, 24.04 (x86_64 and ARM64)
  • NVIDIA Jetson (JetPack)
  • Raspberry Pi OS
  • Any Debian-based Linux distribution

​
Authentication & Access

For the web dashboard, you log in with your account credentials. For the CLI and API, you’ll use an API token that you can generate from your account settings.
Run roboticks auth login and follow the prompts, or set the ROBOTICKS_API_TOKEN environment variable with your API token.
Yes. Use API tokens for non-interactive authentication. The CLI supports all common CI/CD operations including deploying software, running tests, and checking device status.

​
Environments & Projects

Roboticks supports three environments: Production, Testing, and Development. Devices appear in the environment configured during registration. Environments are isolated from each other.
Yes. Projects help organize devices and configurations. The number of projects depends on your subscription tier - Free tier includes 1 project, Team tier includes 5 projects.

​
Logs & Data

Logs are streamed in near real-time with sub-second latency. If you experience delays, check your device’s network connectivity and ensure the system clock is synchronized (NTP).
All logs and artifacts are stored securely in Roboticks cloud storage. You can view them in the dashboard, download them, or access them via the API.
Yes. Use the Logs export feature in the dashboard (supports CSV and JSON formats) or use the CLI: roboticks logs export --session <id> --format json
Log retention depends on your subscription tier. Free tier retains logs for 7 days, Team tier for 30 days, and Enterprise tier offers custom retention periods.

​
Troubleshooting

Check these common causes:
  1. Network: Verify the device can reach api.roboticks.io on port 443
  2. Device Manager: Ensure the service is running: sudo systemctl status roboticks-manager
  3. Capsule: Verify the device capsule was applied correctly
  4. Time sync: Ensure NTP is configured and the clock is accurate
  5. Logs: Check device logs: sudo journalctl -u roboticks-manager -n 50
  1. Verify the device is online in the Fleet view
  2. Check that the composition exists on the device
  3. Review device logs for error messages
  4. Ensure required dependencies are installed on the device
  1. Verify the session is in “Running” state
  2. Check that the device has network connectivity
  3. Wait a few seconds - there may be a brief buffering delay
  4. Check the Device Manager logs for any errors

​
Billing & Limits

The free tier includes:
  • 1 project
  • 1 device
  • 7-day log retention
  • Basic integrations
Go to Settings → Billing in the dashboard and select your desired plan. Changes take effect immediately.

​
Still have questions?

Contact Support

Email our support team

Join Community

Ask questions in our Discord