hetzbot-add-service

Attach and deploy a new service to a fleet host with validation and optional HTTPS.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Attach a new first-party service to a host in the fleet. Triggers: user says "add a service", "deploy <repo>", "wire up <name>". Interactive — asks for inputs, scaffolds services/<name>/, assigns to host, runs deploy.

Core Features & Use Cases

  • Scaffolding & setup: Creates services/<name>/ with an initial repository URL and structure.
  • Host wiring & deployment: Assigns the service to a target host, updates hosts.tfvars, and triggers the deployment workflow.
  • Optional enhancements: Supports HTTPS exposure, DNS configuration, and optional Postgres restore during setup.

Quick Start

Name a new service, choose a target host, and follow the prompts to scaffold and deploy it.

Frequently Asked Questions about hetzbot-add-service

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

FAQPage Schema
How do I automate scaffolding and deploying a new Docker service to a host?

To deploy a Docker service, you name the service, link its Git repository, and choose a target host. The process scaffolds the service directory, updates host Terraform variables, and runs the deployment script on the target host.

Can I configure HTTPS exposure and DNS records when attaching a new service to my fleet?

Yes, you can configure HTTPS exposure and DNS records when attaching a service to your fleet. The deployment process optionally applies DNS configurations and enables HTTPS exposure during the service setup and host wiring workflow.

Does the service deployment workflow support restoring a Postgres database during setup?

Yes, the service deployment workflow supports an optional Postgres database restoration during setup. This allows you to restore a Postgres database directly while attaching and deploying the new service to your target host.

How do I assign both long-running and scheduled services to specific hosts in my fleet?

You assign long-running or scheduled services by defining their service shape during setup. The workflow validates inputs, assigns the chosen service shape to the target host, and updates the infrastructure variables to wire it into the fleet.

What is the best way to verify a new service is running across my fleet after deployment?

The best way to verify a deployed fleet service is using the built-in post-deploy verification. After the deployment script runs on the target host, the workflow automatically performs post-deploy verification to confirm the service is running correctly.

Do I need to manually update Terraform variables when adding a new service to a host?

No, you do not need to manually update Terraform variables. The automated workflow updates the hosts.tfvars file directly when assigning the new service to a host, ensuring your infrastructure configuration stays synchronized automatically.