Deployment
TL;DR
CMDOP supports cloud-hosted and self-hosted deployment. Use the managed cloud service at grpc.cmdop.com for zero-setup operation, or deploy on your own infrastructure via Docker, Kubernetes, or manual installation for full data control and custom networking.
CMDOP can be used as a cloud service or self-hosted.
What deployment options are available?
| Option | Best For |
|---|---|
| Cloud | Quick start, no infrastructure |
| Self-Hosted | Full control, on-premise |
| Docker | Easy deployment |
| Kubernetes | Scale, high availability |
How do I use the cloud service?
Use CMDOP cloud Control Plane:
from cmdop import AsyncCMDOPClient
# Connect to the managed cloud Control Plane (default endpoint: grpc.cmdop.com)
client = AsyncCMDOPClient.remote(api_key="cmd_xxx")Agents connect to grpc.cmdop.com.
Advantages:
- No setup required
- Automatic updates
- Managed infrastructure
- Global availability
How do I self-host CMDOP?
Run your own Control Plane:
- Self-Hosted Guide β Manual installation
- Docker β Docker deployment
- Kubernetes β K8s deployment
Advantages:
- Data stays on your infrastructure
- Custom network configuration
- No external dependencies
- Full control
What are the system requirements?
What does the Control Plane need?
| Resource | Minimum | Recommended |
|---|---|---|
| CPU | 2 cores | 4+ cores |
| Memory | 4 GB | 8+ GB |
| Disk | 20 GB | 50+ GB |
| Network | 100 Mbps | 1 Gbps |
What database is required?
PostgreSQL 14+ required:
- Minimum: 2 GB RAM
- Recommended: 8+ GB RAM for production
What Redis version is needed?
Redis 6+ for pub/sub and caching:
- Minimum: 1 GB RAM
- Recommended: 4+ GB RAM
What is the deployment architecture?
What ports does CMDOP use?
| Port | Protocol | Purpose |
|---|---|---|
| 443 | HTTPS | Web dashboard, REST API |
| 50051 | gRPC | Agent connections |
| 50052 | gRPC | SDK connections |
How is the deployment secured?
How is TLS configured?
All connections require TLS:
- Valid certificate required
- Letβs Encrypt supported
- Self-signed for internal use
How does authentication work?
- OAuth 2.0 for users
- API keys for SDK/agents
- JWT tokens
What are the network requirements?
- Agents initiate outbound connections
- No inbound ports on agents
- Control Plane needs public access (or VPN)
What should I do next?
Manual installation guide
Docker deployment
K8s deployment
Last updated on