Flowmaker SDK [beta]Docs
search
GitHub

Instance Status (./fm ps)

List containers for a FlowMaker instance with their IP addresses and status.

./fm ps <name>

Overview

The ps command shows all Docker containers for an instance, including:

  • Container ID
  • Service name
  • State (running/stopped)
  • IP address on the instance network
  • Status (uptime/restart count)

Examples

Basic Usage

$ ./fm ps dev
Containers for instance 'dev':

CONTAINER ID   SERVICE                      STATE      IP              STATUS
------------   -------                      -----      --              ------
a1b2c3d4e5f6   flowmaker-scheduler          running    192.168.112.2   Up 5 minutes
b2c3d4e5f6a1   flowmaker-confighub          running    192.168.112.3   Up 5 minutes
c3d4e5f6a1b2   flowmaker-logging            running    192.168.112.4   Up 5 minutes
d4e5f6a1b2c3   flowmaker-frontend           running    192.168.112.5   Up 5 minutes
e5f6a1b2c3d4   worker-timer                 running    192.168.112.6   Up 4 minutes
f6a1b2c3d4e5   worker-mqtt-client           running    192.168.112.7   Up 4 minutes

Instance Not Running

$ ./fm ps staging
Containers for instance 'staging':

CONTAINER ID   SERVICE   STATE   IP   STATUS
------------   -------   -----   --   ------
(no running containers)

Output Columns

Column Description
CONTAINER ID Docker container short ID
SERVICE Docker Compose service name
STATE Container state (running, exited, etc.)
IP Container IP address on instance network
STATUS Uptime or exit information

Common Use Cases

Check If Instance Is Running

./fm ps dev | grep running

Find Service IP Address

./fm ps dev | grep scheduler
# Output: a1b2c3d4e5f6   flowmaker-scheduler   running   192.168.112.2   Up 5 minutes

Check Worker Status

./fm ps dev | grep worker

Verify All Services Started

./fm ps dev
# Count lines to verify expected number of services

Troubleshooting

Container in Exited State

./fm ps dev | grep exited
./fm logs dev <service-name>

Service Not Appearing

# Check if service is in compose file
grep <service-name> docker-compose.yml

# Restart instance
./fm down dev
./fm up dev --workers

Related Commands

Command Description
./fm ps <name> List containers for instance
./fm list List all instances
./fm logs <name> View instance logs
docker compose -p fm-dev ps Direct Docker Compose alternative

References