Composure

> Deploy docker-compose files to multiple hosts via SSH with Composure

Composure is a simple CLI tool for deploying Docker Compose applications across multiple remote servers via SSH. No Kubernetes, no Swarm — just your familiar docker-compose.yml files deployed exactly where you want them.

Why Composure?

You have a docker-compose.yml file. You have multiple servers. You want your application running on all of them without the complexity of Kubernetes or the overhead of a full orchestration platform.

Composure keeps it simple:
- Uses your existing docker-compose.yml files
- Deploys over SSH—no agents, no daemons
- Supports server-specific configurations
- Parallel deployments for speed

Install

Homebrew (auto updates)
``sh brew install sprisa/tap/composure`

NPM`sh npm i -g @sprisa/composure

`Or run directly`


npx @sprisa/composure

Golang Source`sh go install github.com/sprisa/composure@latest

`Or run directly`


go run github.com/sprisa/composure@latest



Usage

Add a composure label to your docker-compose services. This described which SSH host to deploy the docker service to. This can be any DOCKER_HOST variable.

`yaml services: # Simple Hello World application hello-world: image: crccheck/hello-world ports: - "8081:8000" restart: unless-stopped labels: composure: ssh://gabe@jackfruit.local # <- Deploy to jackfruit server. Can be any IP or DNS name

# Nginx reverse proxy nginx: image: nginx:alpine ports: - "8080:80" restart: unless-stopped labels: composure: ssh://gabe@mango.local # <- Deploy to mango server. Can be any IP or DNS name`

Now we can deploy withcomposure up. This accepts the same flags as docker compose up.

`sh

`Deploy in background`


composure up -d 
Destroy services

compose down



Options

Show Help`sh ~ ❯ composure Composure - Calm docker compose deployments

Usage: composure

Commands: up - Start services down - Stop services restart - Restart services help - Show this help message``

Why Composure?

You have a docker-compose.yml file. You have multiple servers. You want your application running on all of them without the complexity of Kubernetes or the overhead of a full orchestration platform.

Composure keeps it simple:
- Uses your existing docker-compose.yml files
- Deploys over SSH—no agents, no daemons
- Supports server-specific configurations
- Parallel deployments for speed

Or run directly

go run github.com/sprisa/composure@latest

Usage

Add a composure label to your docker-compose services. This described which SSH host to deploy the docker service to. This can be any

DOCKER_HOST variable.

yaml
services:
  # Simple Hello World application
  hello-world:
    image: crccheck/hello-world
    ports:
      - "8081:8000"
    restart: unless-stopped
    labels:
      composure: ssh://gabe@jackfruit.local # <- Deploy to jackfruit server. Can be any IP or DNS name

  # Nginx reverse proxy
  nginx:
    image: nginx:alpine
    ports:
      - "8080:80"
    restart: unless-stopped
    labels:
      composure: ssh://gabe@mango.local # <- Deploy to mango server. Can be any IP or DNS name


Now we can deploy with

composure up. This accepts the same flags as docker compose up.

sh