Unsupported nginx Directives

Most nginx directives work in Angie unchanged, so an existing configuration usually needs no adjustment. This page lists the exceptions, the directives that Angie removes or deprecates, so you can adapt your configuration when moving from nginx.

Low-level tuning directives that nginx itself leaves undocumented, such as event-method and gzip tuning knobs, keep working in Angie with their nginx defaults and are intentionally omitted here.

Note

For the end-to-end migration process, see the migration guide.

Removed or Omitted

Angie does not carry these nginx directives over.

nginx directive	Notes
add_header_inherit, add_trailer_inherit	Omitted because of their poor design; see Angie Version History.
keepalive_min_timeout	Omitted; delete it. When gracefully shutting down old worker processes, Angie closes keep-alive connections after the smaller of lingering_timeout and keepalive_timeout has expired (5 seconds by default), which covers the same case.
ssl_ech_file	Omitted, along with the $ssl_ech_status and $ssl_ech_outer_server_name variables. Angie implements Encrypted Client Hello through the ssl_encrypted_hello_key directive instead.

Deprecated

These directives still work but emit a warning; use the modern directive instead.

nginx directive	Use instead
http2_idle_timeout	keepalive_timeout
http2_max_requests	keepalive_requests
http2_recv_timeout	client_header_timeout
http2_max_field_size	large_client_header_buffers
http2_max_header_size	large_client_header_buffers
proxy_downstream_buffer (stream)	proxy_buffer_size
proxy_upstream_buffer (stream)	proxy_buffer_size