🎉 Cmdop v1.0 is here! Download now →
Skip to Content
DocsCLIConnect Machines

Connect Machines

Make any machine accessible through Cmdop.

Quick Connect

cmdop connect

This registers the current machine and starts the agent.

Named Connection

cmdop connect --name "production-server"

With Tags

cmdop connect --tags "production,web,us-east"

Connection Process

  1. Authentication - Verifies your credentials
  2. Registration - Registers machine with Cmdop servers
  3. Agent Start - Starts background daemon
  4. Tunnel Setup - Establishes secure connection

Machine Types

Personal Machines

Your own computers that you directly manage.

cmdop connect

Servers

Remote servers without GUI.

cmdop connect --headless

Shared Machines

Machines shared with your team.

cmdop connect --workspace my-team

Verify Connection

cmdop agent status

Expected output:

Agent Status: Running Machine ID: abc123 Connected: Yes Uptime: 2h 34m

Connection Troubleshooting

Firewall Issues

Cmdop uses outbound connections only. Ensure these are allowed:

  • wss://relay.cmdop.com:443
  • https://api.cmdop.com:443

Behind Proxy

export HTTPS_PROXY=http://proxy.example.com:8080 cmdop connect

Connection Drops

The agent automatically reconnects. Check logs:

cmdop agent logs

Disconnect

Temporary disconnect:

cmdop disconnect

Remove machine completely:

cmdop disconnect --remove

Connect Machines | Cmdop