Control Plane Overview

rauto-manager is a self-hosted control plane for rauto agent fleets. It centralizes execution node management, shared inventory, task dispatch, and live execution visibility.

Relationship to rauto

Project	Role	Best for
rauto	Execution engine, local tool, and agent runtime	Single-node execution, local UI, templates, and transaction capabilities
rauto-manager	Central control plane	Multi-agent management, shared inventory, centralized dispatch, and live visibility

Main capabilities

Based on the source and README, rauto-manager mainly provides:

• agent onboarding and registration
• shared device inventory
• task dispatch
• visual design for tx_workflow and orchestrate
• live execution events and timelines
• history, notifications, and admin operations
• English and Chinese UI

Tech stack

• Next.js 16
• React 19
• Prisma 7
• PostgreSQL
• next-intl

Quick start

Install dependencies

npm install

Configure environment variables

cp .env.example .env

Common required values include:

• DATABASE_URL
• JWT_SECRET
• AGENT_API_KEY

Apply database migrations

npx prisma migrate deploy

Start the app

npm run dev

The default local address is http://localhost:3000.

Connect a rauto Agent

HTTP reporting example:

rauto agent \
  --bind 0.0.0.0 \
  --port 8123 \
  --manager-url http://<manager-host>:3000 \
  --report-mode http \
  --agent-name edge-sh-01 \
  --agent-token <same-agent-api-key>

gRPC reporting example:

rauto agent \
  --bind 0.0.0.0 \
  --port 8123 \
  --manager-url http://<manager-host>:50051 \
  --report-mode grpc \
  --agent-name edge-sh-01 \
  --agent-token <same-agent-api-key>

Status in this docs site

This docs site currently prioritizes rauto product and usage documentation. The rauto-manager section is intentionally kept at overview level for now. Good next additions would be:

• installation and deployment
• agent onboarding and authentication
• task dispatch models
• designer usage documentation
• manager APIs and data model details