Products · Product
Caddy
Raised as a usability problem by 37 people on Hacker News over 13 years (2013–2025), in 23 threads.
No issue was raised by at least 3 people in 3 threads this year.
No issue was raised by at least 3 people in 3 threads in the last 5 years.
Every issue, all time, most people first
Couldn't find where the Caddyfile belongs; docs unstructuredUnreviewed
20132026- Couldn't find where to put the Caddyfile; docs are messy and unstructured2024-10-04
- Caddyfile syntax is confusing and hard to learn without a good tutorial2024-02-27
- Confused by v2 docs because they no longer centre the Caddyfile2020-09-10
Unreviewed issues were grouped by machine: Claude Haiku labelled each comment as a usability complaint, named what it's about and summed up the problem in a line, and a small model grouped similar problems. Nobody has checked them by hand. Expect mistakes.
The newest 45 complaints
- Docs mix outdated config examples and plugin-only options, making path rewriting hard to set up2025-02-16
- Couldn't find where to put the Caddyfile; docs are messy and unstructured2024-10-04
- Docs are in formats the reader doesn't use, forcing them to translate options themselves2024-10-03
- Implicit automatic behaviour makes failures hard to debug and trust2024-06-01
- Invalid configs are silently accepted, so things just don't work as expected2024-02-27
- Caddyfile syntax is confusing and hard to learn without a good tutorial2024-02-27
- Terminal demos are hard to follow due to distracting 3D distortion and unclear purpose2023-12-11
- Confusing config formats and tiny doc snippets that don't show where they fit2023-08-16
- Docs steer users to confusing JSON API config instead of the simpler Caddyfile2023-05-24
- Docs show directive syntax but not where it goes in the config2023-05-24
- Docs and forums reference outdated v1, making it confusing to find current info2023-05-23
- Docs steer users toward the JSON API and hide the familiar config syntax2023-05-23
- Takes longer to work out how to do non-trivial things2022-08-24
- Adding the Cloudflare DNS plugin requires a slow, RAM-heavy custom rebuild of the image2022-08-24
- Hard to learn: docs and config syntax are confusing until the commenter understood the websocket scenario2022-05-24
- Can't tell from config snippet whether it matches requests or modifies headers2022-05-24
- Must duplicate every virtual hostname config because DNS names aren't handled correctly2022-05-23
- Can't tell from the config whether the header directive matches requests or sets headers2022-05-23
- Hard to find instructions for a wildcard certificate setup2022-05-23
- Can't tell whether header lines match or add headers without deep knowledge2022-05-23
- Took too long to enable a simple feature; it silently failed with no errors2022-05-19
- Hard to work out how to configure things; some options need a giant JSON export2022-04-26
- Hard to see how to set up basic auth for a common case from the page2022-04-23
- Documentation is fragmented across terse pages, making readers lose their place2022-03-27
- Hard to find how the ask function works; required trial and error2022-03-02
- Implied $PWD and defaults confused beginner for 15 minutes in Docker2021-08-20
- Hard to find config items; layout separated from explanations, forcing constant Ctrl+F searching2021-08-20
- Instructions don't work and it's hard to diagnose the ACME DNS challenge errors2020-11-07
- Docs only cover trivial examples or very intricate JSON, not mid-complexity setups2020-09-11
- Can't get Bitwarden's SSL working with Caddy 2, so certificates need manual renewal2020-09-10
- Hard to find what you need; content scattered across issues, community posts, and unlinked pages2020-09-10
- Confused by v2 docs because they no longer centre the Caddyfile2020-09-10
- Searching a directive name returns module docs instead of the directive docs page2020-09-10
- Some docs pages are only reachable via links inside other pages, not the sidebar2020-09-10
- Search box is placed unusually and styled so subtly it goes unnoticed2020-05-05
- Navigation and flow of documentation content could be improved, and there is a lot to learn2020-05-04
- Can't figure out how to include a plugin they rely on2020-05-04
- Couldn't find a page after searching for half an hour2020-05-04
- Can't find a list of default plugins or how to configure them2020-05-04
- Server exits on boot if any HTTPS site fails certificate, taking all sites down2019-03-12
- Caddy's certificate fetching behaves dangerously and is user-hostile, risking downtime for critical sites2019-03-11
- Refuses to start when Let's Encrypt ACME API is unavailable, despite valid cached certificate2017-09-13
- Manual setup of launch daemons, working directories and permissions takes longest when getting it running2017-04-21
- Documentation pages download a templates.gz file instead of opening on Windows Chrome2015-04-28
- Configuration gets too complex with multiple apps, domains and rewrite rules2013-08-01