Products · Product
nginx
Raised as a usability problem by 36 people on Hacker News over 17 years (2010–2026), in 33 threads.
No issue was raised by at least 3 people in 3 threads this year.
Every issue, all time, most people first
Configuration is unintuitive, poorly documented and easy to breakUnreviewed
20102026- Documentation is almost useless and config changes have hidden surprises2026-05-13
- Configuration is unintuitive and poorly documented, easy to break2023-02-21
- Unintuitive and poorly documented, making it easy to misconfigure2023-02-21
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 39 complaints
- Documentation is almost useless and config changes have hidden surprises2026-05-13
- One unavailable upstream container stops the whole server starting, taking down all sites2025-11-19
- Setting up PHP or reverse proxies requires a lot of manual configuration work2025-10-16
- Documentation too thin for non-basic setups; user can't get wildcard certificate syntax working2025-08-14
- Add_header inheritance is counterintuitive, though it stops being a problem once learned2025-02-16
- Installing ModSecurity on Nginx means manually compiling many dependencies, which is long-winded2024-08-15
- Python runtime packages only cover defaults, forcing manual source builds for other versions2024-06-01
- Documentation is full of non-explanations, hard to learn from2024-05-06
- Tutorials gave wrong PHP version config, so nginx couldn't find PHP with no clear error2023-08-13
- Config file format is confusing and the docs are unclear2023-05-30
- Considered a disaster from a usability point of view2023-02-22
- Confusing config rules, unhelpful errors, and footgun defaults make it hard to work with2023-02-22
- Configuration is unintuitive and poorly documented, easy to break2023-02-21
- Unintuitive and poorly documented, making it easy to misconfigure2023-02-21
- One missing DNS record for a proxied site takes down the whole instance2022-08-24
- Configuration file design is poor and hard to work with2022-08-24
- Nginx configuration interface is terrible and hard to use2022-08-24
- Hard to find correct dependencies amid deprecations and poor documentation2022-06-27
- Hard to configure well, with endless hidden options and unhelpful documentation2022-03-31
- Using $uri in redirects or proxy_pass easily leads to unsafe, broken behaviour2022-02-23
- Confusing config rules for alias vs root, slashes, and location priority; must Google each time2022-02-23
- Obtuse config with random gotchas and minimal docs, hard to get working2021-11-03
- Nested config blocks make it unclear which options apply, so headers must be duplicated2021-05-23
- Module feels unwieldy to use; author struggles with Nginx's configuration approach2021-04-19
- Finds Nginx configuration so badly designed that the commenter never learned it2021-02-25
- Only a raw text editor; common settings need manual config editing instead of controls2020-06-22
- Requires too much configuration and is brittle without a dedicated DevOps person monitoring it2020-05-04
- Nginx configuration logic is somewhat counter-intuitive to work out2019-04-25
- Documentation is terrible, so setup is hard to figure out2018-06-07
- Hard to find a list of changes in the new version2018-04-25
- Config language has unintuitive limitations from mixing declarative and procedural elements, with arbitrary directive precedence2015-09-23
- Route order in config matters unpredictably once regular expressions are involved2014-11-19
- Config syntax has surprising behavior that needs a separate gotchas page2013-06-20
- Nginx documentation still has a long way to go2013-06-19
- Location evaluation order and if statements behave unintuitively and catch people out2012-07-07
- Location matching order is unintuitive and quirky, hard to predict2012-07-07
- Text font is almost impossible to read2012-03-23
- Hard to work out where config bits go and how the syntax is parsed2012-02-21
- Nginx config is hard to work with programmatically; extracting settings is horrible for admins2010-06-25