GitHub - HerrMuellerluedenscheid/hoister: deploy and rollback containers with ease 🦀

Deploy Docker images automatically with rollback support.

Full documentation at docs.hoister.io

Quick start

Mint an agent token at hoister.io (sign in, then open Tokens). Add the hoister.enable=true label to any service you want Hoister to manage, then add Hoister itself to the same Compose file:

services:
  example:
    image: myorg/myapp:latest
    labels:
      - "hoister.enable=true"

  hoister:
    image: hoister/hoister:latest
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    security_opt:
      - no-new-privileges:true
    environment:
      # Report to the hosted dashboard at api.hoister.io (the default
      # controller URL). Paste the token you minted above.
      HOISTER_CONTROLLER_TOKEN: "hst_<your-token>"

Push a new image under the same tag — Hoister will pull it and restart the container automatically. If the new container fails to start, it rolls back to the previous version, and the result shows up on your dashboard.

Prefer no hosted dashboard? Drop the HOISTER_CONTROLLER_TOKEN line and Hoister runs standalone — same auto-update and rollback, with no telemetry leaving the host.

See the Getting Started guide for a full walkthrough including volume backups.

Learn more

License

The agent (agent/), frontends (frontend/, frontend-cloud/), shared crate (hoister_shared/), and documentation are MIT-licensed. See the top-level LICENSE.

The controller (controller/) is licensed under AGPL-3.0-only — modifications offered as a network service must be published under the same license.