hotify-integration

name	hotify-integration
description	hotify-cli integration for SuperLandings Go - DNS, Traefik, and reverse proxy configuration

hotify-cli Integration for SuperLandings Go

Overview

SuperLandings Go integrates with hotify-cli for DNS management and Traefik reverse proxy configuration. However, there are important limitations to understand.

Critical Limitation: setup-traefik vs Router Configuration

setup-traefik is for ACME certificates ONLY

The hotify-cli setup-traefik command is specifically for ACME certificate setup (SSL/TLS), NOT for router/service configuration in Traefik.

When using --backend-url:

• hotify-cli stores the backend URL in ~/.hotify/config.json
• It DOES generate router/service configuration in /etc/traefik/dynamic.yml (as of v2.10.1)
• Path prefix middleware is now supported via --path-prefix flag

Deployment Workflow

1. Register App with hotify-cli

hotify-cli setup --id <APP_ID> --name <APP_NAME> --domain <DOMAIN> --port <PORT> --backend-url http://127.0.0.1:<PORT> --cmd 'sleep infinity' --path-prefix /<SITE_SLUG>

Why sleep infinity?

• hotify-cli expects a command that keeps the process alive
• true exits immediately, breaking the proxy
• sleep infinity keeps the process running as a placeholder

Why --path-prefix?

• Services like sl-cli serve sites at paths like /<SITE_SLUG>/, /other-site/