ssh-docker-compose-ps

List and filter Docker Compose project services over SSH.

6|Updated Apr 17, 2026

Search Tags:#docker #docker compose #service management #docker compose ps #docker compose status

Ready to run

npx skills add https://github.com/Nightreaver/python-ssh-mcp --skill ssh-docker-compose-ps

💬 Prompt for ChatGPT / Claude Chat▼

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.