remote-status

Remote Status Command

Compare the Docker image running on your remote host with the latest image in the registry.

📋 TEMPLATE: This command is a template. See "Customization Guide" below to adapt for your infrastructure.

Deployment Modes

Most Docker setups support two deployment modes:

Mode	Container Name	Port	Use Case
Development	{{PROJECT}}-dev	3000	Hot-reload, source-mounted, local dev tools
Staging	{{PROJECT}}-staging	3001	Production-like, self-contained, stable

Dev mode uses standard ports so local tools work by default. Staging mode is recommended - it's stable and won't break during git pull.

Workflow

1. Get Running Container Info

Check running container on remote host:

# ┌─────────────────────────────────────────────────────────────────────┐
# │ CUSTOMIZE: Replace with your SSH and container details              │
# └─────────────────────────────────────────────────────────────────────┘

# Check dev container
ssh -i {{SSH_KEY_PATH}} {{REMOTE_USER}}@{{REMOTE_HOST}} \
  "docker ps --filter name={{PROJECT}}-dev --format 'table {{.Names}}\t{{.Image}}\t{{.Status}}'"

# Check staging container
ssh -i {{SSH_KEY_PATH}} {{REMOTE_USER}}@{{REMOTE_HOST}} \
  "docker ps --filter name={{PROJECT}}-staging --format 'table {{.Names}}\t{{.Image}}\t{{.Status}}'"

Extract commit SHA from running container:

ssh -i {{SSH_KEY_PATH}} {{REMOTE_USER}}@{{REMOTE_HOST}} \
  "docker inspect {{CONTAINER_NAME}} | grep 'org.opencontainers.image.revision'"

Get image creation time:

ssh -i {{SSH_KEY_PATH}} {{REMOTE_USER}}@{{REMOTE_HOST}} \
  "docker images {{REGISTRY}}:latest --format '{{.CreatedAt}}'"

2. Get Latest Registry Image Info

Check latest commit on your main branch:

git fetch origin {{MAIN_BRANCH}}
git log origin/{{MAIN_BRANCH}} -1 --format='%H %s'