hetzbot-deploy

Automate fleet deployment by syncing skills and provisioning infrastructure on hosts.

Updated Apr 17, 2026
One-click install
npx skills add https://github.com/tomspiegl/hetzbot --skill hetzbot-deploy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hetzbot-deploy
Source: https://github.com/tomspiegl/hetzbot/tree/main/skills/ops/deploy
Command: npx skills add https://github.com/tomspiegl/hetzbot --skill hetzbot-deploy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Deploying fleet changes across hosts and services is complex, error-prone, and manual without a repeatable automation.

Core Features & Use Cases

  • Syncs skills and fleet data to target hosts using rsync, ensuring host state matches the fleet manifest.
  • Installs universal infrastructure like Docker and Restic, bootstraps per-service runtimes, builds or pulls service code, and manages systemd units and timers for automated operation.
  • Supports rollback by re-deploying previous service states and reassembling Caddy configs on public hosts.

Quick Start

Deploy the specified host to sync the fleet state, install required infrastructure, build services, and start them.

Frequently Asked Questions about hetzbot-deploy

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate fleet deployment to sync services across multiple hosts?

Fleet deployment automation syncs skills and fleet data to target hosts using rsync, ensuring host state matches the manifest. It installs infrastructure like Docker, builds service code, and manages systemd units for automated operation.

What is the best way to handle rollback when a service deployment fails?

Rollback is handled by re-deploying previous service states and reassembling Caddy configs on public hosts. This ensures stable operation if a new service update causes issues on the target host.

Does fleet deployment require valid host credentials and runtime dependencies?

Yes, fleet deployment requires access to the target host with valid credentials. It validates runtime dependencies and per-service lockfiles before executing idempotent deployment steps to ensure success.

Can I use rsync to sync Docker infrastructure and systemd units during host provisioning?

Yes, the deployment process uses rsync to sync fleet data to target hosts, installs universal infrastructure like Docker and Restic, and manages systemd units and timers for automated service operation.

When do I need to trigger a fleet deployment to update host configurations?

Fleet deployment is needed when services or hosts change, such as when service sources are updated, new hosts are added to the fleet, or configuration updates require syncing infrastructure and building code.

Why does deployment validation check per-service lockfiles before building service code?

Per-service lockfiles are validated to ensure dependency consistency before building or pulling service code. This prevents runtime errors and ensures idempotent deployment steps execute reliably on the host.