Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

test

Test SSH connection to a paired host.

Usage

connecto test <HOST>

Arguments

ArgumentDescription
HOSTName of the paired host to test

Description

The test command verifies that SSH connectivity works to a paired host. It:

  1. Looks up the host in ~/.ssh/config
  2. Attempts an SSH connection
  3. Runs a simple command (echo "Connecto test successful")
  4. Reports success or failure

Example

Successful test

connecto test mydesktop

Output:

  CONNECTO TEST

→ Testing connection to: mydesktop

✓ Connection successful!
  → SSH to mydesktop is working.

Failed test

connecto test mydesktop

Output:

  CONNECTO TEST

→ Testing connection to: mydesktop

✗ Connection failed!
  → Error: Connection refused

Troubleshooting:
  • Check if the host is online
  • Verify the IP address: connecto hosts
  • Update IP if changed: connecto update-ip mydesktop <new-ip>

Common issues

ErrorCauseSolution
Connection refusedHost offline or SSH not runningStart the remote machine
Connection timed outWrong IP or network issueUpdate IP with connecto update-ip
Permission deniedKey not in authorized_keysRe-pair with connecto pair
Host key verification failedRemote host changedRemove from ~/.ssh/known_hosts
CommandDescription
connecto hostsList all paired hosts
connecto update-ipUpdate host’s IP address
connecto pairRe-establish pairing