---
title: "Deployments | Coswarm"
description: "Deploy from any registry, a Compose file or the marketplace. Replicas move to the new version one at a time, and every change is kept with who made it."
canonical_url: "https://coswarm.dev/features/deployments"
meta:
  "og:description": "Deploy from any registry, a Compose file or the marketplace. Replicas move to the new version one at a time, and every change is kept with who made it."
  "og:image": "https://coswarm.dev/og.png"
  "og:image:height": "630"
  "og:image:width": "1200"
  "og:title": "Deployments · Coswarm"
  "twitter:image": "https://coswarm.dev/og.png"
---

> Index of every page on this site: [llms.txt](https://coswarm.dev/llms.txt)

Deployments

# Ship an image. Swarm rolls it out.

Deploy from any registry, a Compose file or the marketplace. Replicas move to the new version one at a time, and every change is kept with who made it.

[Install Coswarm](https://coswarm.dev/#install) [Everything in the panel](https://coswarm.dev/features)

panel.acme.dev/apps/shop

**shop**

shop:1.5.0Updating · 1 of 2

shop.1shop:1.5.0running42 s

shop.2shop:1.5.0starting3 s

shop.2shop:1.4.2stops next6 d

**History**

deployshop:1.4.2 → 1.5.0now

envSTRIPE\_MODE changed2 d

scale1 → 2 replicas6 d

## **No downtime by default**

Updates start the new replica before stopping the old one, one at a time, and pause if one fails. Set the failure action to rollback and Swarm goes back on its own.

## **Compose, as Swarm runs it**

Paste a docker-compose file and get its services, volumes and networks. Keys Swarm cannot apply are listed as warnings instead of being dropped quietly.

## **Every knob of a service**

Resources, ports, volumes, networks, secrets, placement, healthcheck, restart and update policy, DNS, sysctls and capabilities, from a form instead of a flag.

## **A history you can read**

Each change becomes a version with its kind and author: a deploy, an env change, a scale. Cosmo compares any two, field by field.

In detail

## What you get

### **Where images come from**

- Public or private registries: Docker Hub, GitHub, GitLab, Quay, AWS ECR, Google and Azure registries, or your own.
- A pasted Compose file, as one stack.
- A marketplace template, with its volumes and secrets set up.

### **Running an app**

- Replicated with a count, or global on every node.
- Start, stop and restart; a terminal into any replica; a file browser inside its container.
- Live CPU and memory, rollout state, and the incidents it has had.

### **Many at once**

- Point several services at a new image or tag and roll them out together, with private registry credentials used.
- Swarm Sync adopts services that already run on the server, without restarting them.

With Cosmo

Cosmo can deploy an image, scale, set environment variables, change resources, ports, networks and volumes, roll back to the previous spec, or install a whole Compose file as one change. Each one waits for your approval.

[How Cosmo works](https://coswarm.dev/cosmo)

- “Deploy ghcr.io/acme/shop:1.5.0 to shop”
- “Install this compose file as a new project”
- “What changed in checkout since yesterday?”

More of the panel

[**Domains & edge** Domains with HTTPS, guarded at the edge.](https://coswarm.dev/features/networking) [**Databases** Your databases, in the browser.](https://coswarm.dev/features/databases) [**Observability** Know what broke before anyone asks.](https://coswarm.dev/features/observability) [**Marketplace** 65 self-hosted apps, one click each.](https://coswarm.dev/features/marketplace) [**Automation** Deploys that run themselves.](https://coswarm.dev/features/ci-cd)

## Your servers are waiting.

One command, a minute or so, and the panel is on your domain. Free, and yours to keep.

$`curl -fsSL https://coswarm.dev/install.sh | bash`

[See the panel](https://coswarm.dev/features) [ Meet Cosmo](https://coswarm.dev/cosmo)

```json
{"@context":"https://schema.org","@graph":[{"@type":"WebPage","@id":"https://coswarm.dev/features/deployments#webpage","url":"https://coswarm.dev/features/deployments","name":"Deployments","description":"Deploy from any registry, a Compose file or the marketplace. Replicas move to the new version one at a time, and every change is kept with who made it.","isPartOf":{"@id":"https://coswarm.dev/#website"}},{"@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://coswarm.dev/"},{"@type":"ListItem","position":2,"name":"Features","item":"https://coswarm.dev/features"},{"@type":"ListItem","position":3,"name":"Deployments","item":"https://coswarm.dev/features/deployments"}]}]}
```

```json
{"@context":"https://schema.org","@graph":[{"@id":"https://coswarm.dev/#website","@type":"WebSite","description":"Coswarm turns your Linux servers into a Docker Swarm platform: deploys, domains with automatic HTTPS, databases and logs in one panel, free to self-host. Cosmo, its assistant, reads the cluster and proposes changes you approve.","name":"Coswarm","url":"https://coswarm.dev/"},{"@id":"https://coswarm.dev/features/deployments#webpage","@type":"WebPage","description":"Deploy from any registry, a Compose file or the marketplace. Replicas move to the new version one at a time, and every change is kept with who made it.","name":"Deployments","url":"https://coswarm.dev/features/deployments","isPartOf":{"@id":"https://coswarm.dev/#website"},"potentialAction":[{"@type":"ReadAction","target":["https://coswarm.dev/features/deployments"]}]}]}
```

## Sitemap

See the full [sitemap](https://coswarm.dev/sitemap.md) for all pages.