The operator’s handbook

From your first project
to a verified operation.

Learn how GroundControl thinks about your infrastructure, then follow the path that matches where you are.

Before the commands

Understand the GroundControl approach.

What is a deployment? How is a project different? What does an agent actually control?

The GroundControl approach

Hosts, projects, deployments, agent grants and the philosophy behind them.

Install & claim

Choose local Docker or a remote Linux server and open your private setup link.

After installation

Review the host scan and follow a checklist for your first application.

Projects & deployments

Pick a folder or GitHub repository, then connect or launch deployment instances.

Publish over HTTPS

DNS, Caddy, tunnels and OAuth discovery checks.

Discover your workloads

Scan paths, Compose files, Docker labels, candidates and missing results.

Enrol an existing app

Enrollment, project grouping, tracking mode and source identity.

Deploy a new app

Choose a template, verify source, review configuration and deploy.

Connect your agent

MCP client requirements, OAuth consent and a step-by-step ChatGPT example.

Deploy & automate

Controlled redeploys, operation evidence and merge automation.

Upgrade & recover

Preview, backup, guarded upgrades and data-preserving uninstall.

Troubleshooting

Connection, consent, visibility, timeouts and verification problems.

Deployment evidence

Real desktop captures, operation records and downloadable health evidence.