---

name: ssh-remote-connection description: SSH connection to remote servers. Use when you need to execute commands on a remote server, check logs, restart services, or manage Docker containers.

SSH Remote Connection

Universal skill for connecting to remote servers via SSH.

Usage

# Interactive shell
scripts/connect.sh

# Run command directly
scripts/connect.sh "docker compose logs backend --tail 50"

Setup

For Claude Code (local)

1. Copy config template:

   cp config/.env.example config/.env
   

2. Fill in config/.env with actual values

   Key-based authentication:

   SSH_HOST=your-server.example.com
   SSH_USER=ubuntu
   SSH_AUTH_METHOD=key
   SSH_KEY_PATH=/absolute/path/to/private/key
   SSH_KEY_PASSWORD=
   SERVER_PROJECT_PATH=/path/to/project
   

   Password-based authentication:

   SSH_HOST=your-server.example.com
   SSH_USER=ubuntu
   SSH_AUTH_METHOD=password
   SSH_PASSWORD='your account password'
   SERVER_PROJECT_PATH=/path/to/project
   

3. Make script executable:

   chmod +x scripts/connect.sh
   

For Cloud Runtime

Set environment variables in your cloud configuration:

• SSH_HOST — server hostname or IP
• SSH_USER — SSH username
• SSH_PORT — SSH port (optional)
• SSH_AUTH_METHOD — auto, key, or password (optional, defaults to auto)
• SSH_KEY_PATH — path to private key for key authentication
• SSH_KEY_PASSWORD — key passphrase (optional)
• SSH_PASSWORD — SSH account password for password authentication
• SERVER_PROJECT_PATH — project directory on server

For password authentication, the local runtime must have either sshpass or expect. If the host key is not trusted yet, connect once manually or add the host to known_hosts before running non-interactive commands.

Important Notes

• Git operations: Do NOT run git pull on the server. User will handle git sync manually.
• Code location: Code is in a private repo, changes must be pushed first then pulled by user.
• Docker: Use docker compose (not docker-compose) on the server.

Example Commands

# View logs
scripts/connect.sh "docker compose logs backend --tail 100"

# Restart service
scripts/connect.sh "docker compose restart backend"

# Rebuild and restart
scripts/connect.sh "docker compose build backend && docker compose up -d backend"

# Check status
scripts/connect.sh "docker compose ps"