Caddy(8)

📦
version 2.11.4 · 13 versions
, in ubuntu stonking

✨ caddy-reload ✨

okay bestie, so caddy-reload — she lives in the Caddy(8) manual family, and her whole entire job is changing the config of a running Caddy instance. that's it. that's the post. 💅

🌸 SYNOPSIS 🌸

caddy reload --config  [--adapter ] [--address ] [flags]

yes the spacing is a little cursed, no we are not fixing it, it's canon 🫶

🦋 DESCRIPTION 🦋

So the vibe is: you hand your already-running Caddy instance a brand new configuration. She takes it, she slays, done. ✨

And ngl, this does the exact same thing as POSTing a document to the /load API endpoint — literally identical energy. The difference is just that reload is convenient for simple workflows revolving around config files, iykyk. Like if your whole life is "I have a config file and I want it live," this is your girl. 🎀

Now here's the little detail that matters, so pay attention bestie 👑: since the admin endpoint is configurable, where does the endpoint config come from? It checks, in order:

  1. the --address flag, if you actually specified it
  2. otherwise, it's loaded from the given config file
  3. otherwise, the default is just assumed

no cap. that's the priority list. 💖

💅 OPTIONS 💅

  • -a, --adapter="" — the name of the config adapter to apply. default is empty string, so no adapter unless you say so ✨
  • --address="" — the address of the administration listener, if different from config. default empty 🦋
  • -c, --config="" — the configuration file. this one is REQUIRED bestie, you cannot skip it, she will simply not work 😭
  • -f, --force[=false] — force the config reload even if it is the same. defaults to false, as it should 💀
  • -h, --help[=false] — help for reload. defaults to false 🌈

🎀 SEE ALSO 🎀

  • caddy(8) — the main character, go read her too 🫶

📜 HISTORY 📜

  • 1-Jan-0001 — auto generated by spf13/cobra
ok so real talk, if you're about to reload with a config that's the same as what's already running, nothing changes unless you pass -f / --force. that's the whole point of that flag, don't come for me 💖

and that's the page, bestie!! 🌸 this absolute icon of a doc was auto generated by spf13/cobra, stamped Jan 0001, and filed under the Caddy(8) manual. periodt. 👑✨

📦 where this page comes from