Frequently Asked Questions
Common questions about using Roboticks for robot fleet management.Getting Started
What is Roboticks?
What is Roboticks?
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.
Do I need to modify my ROS2 code to use Roboticks?
Do I need to modify my ROS2 code to use Roboticks?
No. Your ROS2 nodes run unchanged. Roboticks wraps your existing applications and manages their lifecycle, logging, and deployment without requiring code changes.
What devices does Roboticks support?
What devices does Roboticks support?
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
Do I need API keys to use Roboticks?
Do I need API keys to use Roboticks?
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.
How do I authenticate the CLI?
How do I authenticate the CLI?
Run
roboticks auth login and follow the prompts, or set the ROBOTICKS_API_TOKEN environment variable with your API token.Can I use Roboticks in CI/CD pipelines?
Can I use Roboticks in CI/CD pipelines?
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
What environments are supported?
What environments are supported?
Roboticks supports three environments: Production, Testing, and Development. Devices appear in the environment configured during registration. Environments are isolated from each other.
Can I have multiple projects?
Can I have multiple projects?
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
How fast are logs delivered?
How fast are logs delivered?
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).
Where are logs and artifacts stored?
Where are logs and artifacts stored?
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.
Can I export logs in bulk?
Can I export logs in bulk?
Yes. Use the Logs export feature in the dashboard (supports CSV and JSON formats) or use the CLI:
roboticks logs export --session <id> --format jsonHow long are logs retained?
How long are logs retained?
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
My device shows as Offline - how do I fix it?
My device shows as Offline - how do I fix it?
Check these common causes:
- Network: Verify the device can reach
api.roboticks.ioon port 443 - Device Manager: Ensure the service is running:
sudo systemctl status roboticks-manager - Capsule: Verify the device capsule was applied correctly
- Time sync: Ensure NTP is configured and the clock is accurate
- Logs: Check device logs:
sudo journalctl -u roboticks-manager -n 50
Sessions won't start - what should I check?
Sessions won't start - what should I check?
- Verify the device is online in the Fleet view
- Check that the composition exists on the device
- Review device logs for error messages
- Ensure required dependencies are installed on the device
I'm not seeing real-time logs
I'm not seeing real-time logs
- Verify the session is in “Running” state
- Check that the device has network connectivity
- Wait a few seconds - there may be a brief buffering delay
- Check the Device Manager logs for any errors
Billing & Limits
What's included in the free tier?
What's included in the free tier?
The free tier includes:
- 1 project
- 1 device
- 7-day log retention
- Basic integrations
How do I upgrade my subscription?
How do I upgrade my subscription?
Go to Settings → Billing in the dashboard and select your desired plan. Changes take effect immediately.