StackPanel

Caddy Library

Documentation for the caddy module

Pure functions for managing a local Caddy reverse proxy.

Overview

Provides scripts for Caddy lifecycle management, site configuration, and Step CA TLS integration. Used by services/caddy.nix (the NixOS module) and apps/apps.nix (for vhost registration).

Functions

FunctionDescription
mkProjectPort { name }Compute a stable port from project name
mkCaddyScripts { stepEnabled, stepCaUrl, stepCaFingerprint }Generate all Caddy management scripts

Scripts

ScriptDescription
caddy-startStart or reload Caddy
caddy-stopStop Caddy
caddy-restartRestart Caddy
caddy-statusCheck if Caddy is running
caddy-add-siteAdd a virtual host
caddy-remove-siteRemove a virtual host
caddy-list-sitesList configured sites
caddy-project-portGet project port from directory

On this page