Nginx Configuration Pro

A typo in nginx.conf means downtime. Nginx Configuration Pro catches misconfigurations as you type — so you ship with confidence, not anxiety. Validates 1090+ directives, navigates complex multi-file configs, and provides one-click fixes for common issues.

Catch Errors Before They Reach Production

• 27 inspections with 26 quick fixes — wrong contexts, invalid parameters, missing semicolons, undefined upstreams, SSL best practices, expanded security audit checks, performance checks, ReDoS detection, and more. One-click fixes for common issues.
• Run nginx -t from the IDE — the Nginx Operations tool window validates every nginx root config in your project against a local nginx binary or any running Docker container, shows results in a per-root tree with clickable error hyperlinks, and switches environments from a single selector.
• Context-aware autocomplete — suggests only directives valid in the current block. Completes upstream names in proxy_pass, paths in include, and variable names.
• Quick documentation — hover over any directive or variable to see its description, allowed contexts, and a link to official nginx docs.

Navigate and Refactor with Confidence

• Go to Definition — Ctrl+Click on include paths, upstream names, variables, and named locations. Supports glob patterns in includes.
• Find Usages — see where any upstream, variable, or named location is referenced across your project.
• Rename — rename upstreams, variables, and named locations with automatic reference updates across all config files.
• Safe Delete — checks usages before removing upstreams or files.
• Breadcrumbs — always see where you are: http > server > location /api.

Write Configs Faster

• 30+ live templates — type proxy + Tab for a reverse proxy block, ssl + Tab for SSL config. Covers WebSocket, PHP-FPM, static files, CORS, rate limiting, caching, and more.
• Intentions — extract blocks to include files, inline includes, convert listen to IPv6, add SSL redirects — all via Alt+Enter.
• Code formatting — reformat entire configs with column alignment in map, geo, and types blocks.

Beyond Standard Nginx

• Custom directives — define your own directives with allowed contexts and parameter descriptions. Share definitions with your team via Settings > Tools > Nginx Custom Directives.
• Docker support — recognizes *.conf.template files with ${VARNAME} envsubst placeholders.
• Third-party modules — OpenResty (Lua, Echo, Headers More), Brotli, MaxMind GeoIP2.
• Lua blocks — syntax highlighting inside content_by_lua_block and similar directives (requires a Lua plugin).

Getting Started

1. Install the plugin and open any .conf or nginx.conf file — inspections and autocomplete work immediately
2. Open the Nginx Operations tool window and click Validate to run nginx -t on every root config — pick a local binary or a running Docker container in the environment selector
3. Try Ctrl+Click on an include path or upstream name to navigate
4. Type proxy + Tab inside a location block to insert a reverse proxy template

Links

• Documentation
• Report an issue
• Other plugins by meanmail