Docker Remote Skill

Remotely manage Docker Compose instances through SSH connections.

Overview

This skill provides a complete set of actions for Docker Compose lifecycle management on remote servers. All operations are performed via SSH, requiring only standard SSH and Docker tools on both client and server.

Quick Start

CODEBLOCK0

Actions

dockercomposeup

Start Docker Compose services in detached mode.

Parameters:

• - host (required): Remote SSH host (IP or hostname)
• INLINECODE1 (required): SSH username
• INLINECODE2 (required): Directory containing docker-compose.yml
• INLINECODE3 (optional, default: 22): SSH port
• INLINECODE4 (optional): SSH private key path
• INLINECODE5 (optional, default: 60): Operation timeout in seconds

Example:
CODEBLOCK1

dockercomposedown

Stop and remove containers, networks, and volumes defined in docker-compose.yml.

Parameters: Same as INLINECODE6

Example:
CODEBLOCK2

dockercomposestart

Start specific stopped services.

Parameters:

• - All up parameters
• INLINECODE8 (optional): Service name to start (starts all if not specified)

Example:
CODEBLOCK3

dockercomposestop

Stop running services without removing them.

Parameters:

• - All up parameters
• INLINECODE10 (optional): Service name to stop (stops all if not specified)

Example:
CODEBLOCK4

dockercomposerestart

Restart services.

Parameters:

• - All up parameters
• INLINECODE12 (optional): Service name to restart

Example:
CODEBLOCK5

dockercomposeps

List all containers with their status.

Parameters: Same as INLINECODE13

Example:
CODEBLOCK6

dockercomposelogs

Fetch and display logs from services.

Parameters:

• - All up parameters
• INLINECODE15 (optional): Filter logs to specific service
• INLINECODE16 (optional, default: 100): Number of lines to show
• INLINECODE17 (optional, default: false): Stream logs continuously

Example:
CODEBLOCK7

dockercomposeupdate

Pull the latest images and restart services.

Parameters:

• - All up parameters
• INLINECODE19 (optional, default: false): Force recreate containers
• INLINECODE20 (optional): Image pull policy (never, always, missing)
• INLINECODE21 (optional): Custom command to execute instead of default "pull && up"

Example:
CODEBLOCK8

dockercomposeexec

Execute a command in a running container.

Parameters:

• - All up parameters
• INLINECODE23 (required): Container name to execute in
• INLINECODE24 (required): Command to execute
• INLINECODE25 (optional, default: 60): Command execution timeout

Example:
CODEBLOCK9

Implementation Notes

• - SSH connections use key-based authentication by default
• Always change to the correct directory before running docker compose commands
• Use -d flag for detached mode when starting services
• Handle SSH connection timeouts and authentication failures gracefully
• Return structured output with success/failure status and relevant logs
• Include error context when operations fail

Error Handling

Common errors and handling:

1. 1. SSH connection refused: Verify host, port, and network access
2. Authentication failed: Check SSH key path and permissions
3. Path not found: Ensure docker-compose.yml exists at specified path
4. Docker not running: Verify Docker daemon is accessible on remote host
5. Permission denied: Check user has access to Docker socket

Deployment Configuration

This skill supports a deploy-apps.json configuration file that maps your remote hosts and applications. The Agent automatically reads this configuration to resolve host aliases, app names, SSH credentials, and file paths.

Configuration File

The structure of the deploy-apps.json file should be as follows:

CODEBLOCK10

How It Works

When you reference a host alias or app name, the Agent:

1. 1. Reads deploy-apps.json to find the matching configuration
2. Resolves host to the actual SSH hostname/IP
3. Constructs path from INLINECODE32
4. Uses the configured user for SSH authentication

Configuration Parameters

Path Resolution Example

With:

• - base-dir: INLINECODE41
• INLINECODE42: INLINECODE43

The resolved path would be: INLINECODE44

See Also

• - Usage Reference - Detailed parameter documentation
• Examples - Command examples
• Deployment Configuration - Example configuration file