Skip to Content

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?

OptionBest For
CloudQuick start, no infrastructure
Self-HostedFull control, on-premise
DockerEasy deployment
KubernetesScale, 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:

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?

ResourceMinimumRecommended
CPU2 cores4+ cores
Memory4 GB8+ GB
Disk20 GB50+ GB
Network100 Mbps1 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?

PortProtocolPurpose
443HTTPSWeb dashboard, REST API
50051gRPCAgent connections
50052gRPCSDK 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