addedInput schema / additionalProperties
Added value: +false
addedInput schema / properties / documentRoot
Added value: +{
+ "default": "/var/www/html",
+ "description": "Filesystem path served as the web root (DocumentRoot / root).",
+ "type": "string"
+}
addedInput schema / properties / errorPages
Added value: +{
+ "additionalProperties": {
+ "description": "Path served for this HTTP status code.",
+ "type": "string"
+ },
+ "description": "Map of HTTP status code (as key) to a custom error-page path.",
+ "type": "object"
+}
addedInput schema / properties / gzip / default
Added value: +false
addedInput schema / properties / gzip / description
Added value: +"Emit gzip / compression directives for text responses."
addedInput schema / properties / httpPort
Added value: +{
+ "default": 80,
+ "description": "Plain-HTTP listen port.",
+ "minimum": 1,
+ "type": "integer"
+}
addedInput schema / properties / httpsPort
Added value: +{
+ "default": 443,
+ "description": "HTTPS listen port (used only when ssl.enabled is true).",
+ "minimum": 1,
+ "type": "integer"
+}
addedInput schema / properties / logging
Added value: +{
+ "additionalProperties": false,
+ "description": "Access / error log settings.",
+ "properties": {
+ "accessLog": {
+ "description": "Access-log file path.",
+ "type": "string"
+ },
+ "errorLog": {
+ "description": "Error-log file path.",
+ "type": "string"
+ },
+ "format": {
+ "description": "Log format name or string.",
+ "type": "string"
+ }
+ },
+ "type": "object"
+}
addedInput schema / properties / operation / default
Added value: +"generate"
addedInput schema / properties / operation / description
Added value: +"Mode: generate builds the config text (requires serverName); presets returns the curated starter list and ignores all other fields."
addedInput schema / properties / operation / enum
Added value: +[
+ "generate",
+ "presets"
+]
addedInput schema / properties / php
Added value: +{
+ "additionalProperties": false,
+ "description": "PHP-FPM FastCGI settings.",
+ "properties": {
+ "enabled": {
+ "default": false,
+ "description": "Dispatch .php files to PHP-FPM via FastCGI.",
+ "type": "boolean"
+ },
+ "fpmSocket": {
+ "description": "PHP-FPM socket or address (defaults to /run/php/php-fpm.sock in output when blank).",
+ "type": "string"
+ },
+ "version": {
+ "description": "PHP version label used in generated comments.",
+ "type": "string"
+ }
+ },
+ "type": "object"
+}
addedInput schema / properties / reverseProxy / additionalProperties
Added value: +false
addedInput schema / properties / reverseProxy / description
Added value: +"Reverse-proxy / upstream settings."
addedInput schema / properties / reverseProxy / properties / enabled / default
Added value: +false
addedInput schema / properties / reverseProxy / properties / enabled / description
Added value: +"Forward requests to an upstream backend."
addedInput schema / properties / reverseProxy / properties / preserveHostHeader / default
Added value: +false
addedInput schema / properties / reverseProxy / properties / preserveHostHeader / description
Added value: +"Pass the original Host header to the upstream."
addedInput schema / properties / reverseProxy / properties / upstreamHost / description
Added value: +"Upstream backend host (defaults to 127.0.0.1 in output when blank)."
addedInput schema / properties / reverseProxy / properties / upstreamPort / description
Added value: +"Upstream backend port."
addedInput schema / properties / reverseProxy / properties / upstreamPort / minimum
Added value: +1
addedInput schema / properties / reverseProxy / properties / websocket
Added value: +{
+ "default": false,
+ "description": "Add WebSocket upgrade headers to the proxy.",
+ "type": "boolean"
+}
removedInput schema / properties / reverseProxy / required
Removed value: -[
- "enabled",
- "upstreamHost",
- "upstreamPort",
- "preserveHostHeader"
-]
addedInput schema / properties / security
Added value: +{
+ "additionalProperties": false,
+ "description": "Security-header and server-token settings.",
+ "properties": {
+ "headers": {
+ "additionalProperties": false,
+ "description": "Response security headers to emit (blank values are omitted).",
+ "properties": {
+ "csp": {
+ "description": "Content-Security-Policy value.",
+ "type": "string"
+ },
+ "permissionsPolicy": {
+ "description": "Permissions-Policy value.",
+ "type": "string"
+ },
+ "referrerPolicy": {
+ "description": "Referrer-Policy value.",
+ "type": "string"
+ },
+ "xContentTypeOptions": {
+ "default": false,
+ "description": "Emit X-Content-Type-Options nosniff.",
+ "type": "boolean"
+ },
+ "xFrameOptions": {
+ "description": "X-Frame-Options value (for example SAMEORIGIN).",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "hideServerHeader": {
+ "default": false,
+ "description": "Suppress the server version token where supported.",
+ "type": "boolean"
+ }
+ },
+ "type": "object"
+}
addedInput schema / properties / serverAliases
Added value: +{
+ "description": "Extra hostnames (ServerAlias / additional server_name entries). Blank entries are dropped.",
+ "items": {
+ "description": "An additional hostname served by this block.",
+ "type": "string"
+ },
+ "type": "array"
+}
addedInput schema / properties / serverName / description
Added value: +"Primary hostname for the virtual host or server block (for example example.com). Required when operation is generate; max 253 chars; underscore is accepted as the nginx default-server placeholder."
addedInput schema / properties / ssl / additionalProperties
Added value: +false
addedInput schema / properties / ssl / description
Added value: +"TLS settings."
addedInput schema / properties / ssl / properties / certPath / description
Added value: +"Path to the TLS certificate (chain) file."
addedInput schema / properties / ssl / properties / enabled / default
Added value: +false
addedInput schema / properties / ssl / properties / enabled / description
Added value: +"Add an HTTPS listener and TLS directives."
addedInput schema / properties / ssl / properties / hsts / default
Added value: +false
addedInput schema / properties / ssl / properties / hsts / description
Added value: +"Emit a Strict-Transport-Security header."
addedInput schema / properties / ssl / properties / hstsAge / default
Added value: +31536000
addedInput schema / properties / ssl / properties / hstsAge / description
Added value: +"HSTS max-age in seconds."
addedInput schema / properties / ssl / properties / hstsAge / minimum
Added value: +1
addedInput schema / properties / ssl / properties / keyPath / description
Added value: +"Path to the TLS private key file."
addedInput schema / properties / ssl / properties / redirectHttp / default
Added value: +false
addedInput schema / properties / ssl / properties / redirectHttp / description
Added value: +"Add a plain-HTTP block that 301-redirects to HTTPS."
addedInput schema / properties / ssl / properties / tlsVersions / description
Added value: +"Allowed TLS protocol versions; defaults to a modern set when empty."
addedInput schema / properties / ssl / properties / tlsVersions / items / description
Added value: +"A TLS protocol version to allow (for example TLSv1.2)."
removedInput schema / properties / ssl / required
Removed value: -[
- "enabled",
- "certPath",
- "keyPath",
- "redirectHttp",
- "hsts",
- "hstsAge",
- "tlsVersions"
-]
addedInput schema / properties / static
Added value: +{
+ "additionalProperties": false,
+ "description": "Static-file serving settings.",
+ "properties": {
+ "enabled": {
+ "default": false,
+ "description": "Emit static-asset handling directives.",
+ "type": "boolean"
+ },
+ "expires": {
+ "description": "Cache expiry for static assets (for example 30d).",
+ "type": "string"
+ },
+ "indexes": {
+ "description": "Index document filenames.",
+ "items": {
+ "description": "An index filename (for example index.html).",
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "type": "object"
+}
removedInput schema / required
Removed value: -[
- "operation",
- "serverName",
- "ssl",
- "reverseProxy",
- "gzip"
-]
changedOutput schema / (root)
Previous value: -nullNew value: +{
+ "properties": {
+ "operation": {
+ "description": "The operation performed (generate or presets).",
+ "type": "string"
+ },
+ "result": {
+ "description": "For generate: the three configs plus warnings and explanation. For presets: a presets array of starter configurations.",
+ "properties": {
+ "apache": {
+ "description": "Apache 2.4 VirtualHost configuration text.",
+ "type": "string"
+ },
+ "caddy": {
+ "description": "Caddy 2 Caddyfile configuration text.",
+ "type": "string"
+ },
+ "explanation": {
+ "description": "Per-section human-readable explanation of the generated config.",
+ "items": {
+ "properties": {
+ "meaning": {
+ "description": "Plain-language description of what that section does.",
+ "type": "string"
+ },
+ "section": {
+ "description": "Name of the config section being explained.",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "nginx": {
+ "description": "nginx server block configuration text.",
+ "type": "string"
+ },
+ "warnings": {
+ "description": "Configuration warnings (for example weak TLS, missing cert paths).",
+ "items": {
+ "description": "A non-fatal advisory about the chosen settings.",
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "type": "object"
+ },
+ "success": {
+ "description": "Whether the request succeeded.",
+ "type": "boolean"
+ }
+ },
+ "type": "object"
+}