ssh-docker-compose-ps

List and filter Docker Compose project services over SSH.

6|Updated Apr 17, 2026
One-click install
npx skills add https://github.com/Nightreaver/python-ssh-mcp --skill ssh-docker-compose-ps
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ssh-docker-compose-ps
Source: https://github.com/Nightreaver/python-ssh-mcp/tree/main/skills/ssh-docker-compose-ps
Command: npx skills add https://github.com/Nightreaver/python-ssh-mcp --skill ssh-docker-compose-ps

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill provides a way to list services and their states in a Docker Compose project, allowing users to quickly identify which services are running, stopped, or in other states.

Core Features & Use Cases

  • List Services: Show all services and their states in a project.
  • Filter by Service: Narrow down the output to a specific service by name.
  • Filter by Status: Filter the output by service status, such as 'running', 'paused', or 'exited'.
  • Use Case: Before restarting or stopping a service, use this Skill to check its current state and ensure it's safe to proceed.

Quick Start

List all services in the project with the following command:

ssh_docker_compose_ps(host="docker1", compose_file="/opt/app/docker-compose.yml")

Frequently Asked Questions about ssh-docker-compose-ps

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I list Docker Compose services and their states on a remote host?

List Docker Compose services and states on a remote host by specifying the target host and compose file path. The tool outputs all services in the project along with their current running, paused, or exited states.

Can I filter Docker Compose service status by a specific service name?

Filter Docker Compose service status by specifying a service name to narrow down the output. This targets a specific service within the project, showing only its current state rather than the entire project list.

How do I check if a Docker Compose service is running before restarting it?

Check if a Docker Compose service is running by filtering the service status output by 'running'. This verifies the current state of the service to ensure it is safe to proceed with a restart or stop action.

Do I need SSH access to check Docker Compose status remotely?

SSH access is required to check Docker Compose status remotely. The tool executes Docker Compose command-line operations over an SSH connection and requires the Docker Compose CLI tool to be installed on the target host.

What Docker Compose statuses can I filter services by?

Filter Docker Compose services by statuses such as 'running', 'paused', and 'exited'. Specifying a status parameter narrows the output to match only those services currently in that specific state.

Why does my Docker Compose ps command require a compose file path?

The Docker Compose ps command requires a compose file path to identify the correct project. Specifying the compose file location ensures the tool lists services and states for the intended Docker Compose project configuration.