.. image:: misc/logo.gif :alt: Angie logo :target: https://en.angie.software/

Angie

Angie /ˈendʒi/ is an efficient, powerful, and scalable web server that was forked from nginx to act as a drop-in replacement, so you can use existing setups without major changes to module layout or configuration.

The project was conceived by ex-devs from the original nginx team to venture beyond the earlier vision.

Getting Started

To start using Angie, see the official documentation in English <https://en.angie.software/angie/docs/>, Russian <https://angie.software/angie/docs/>, Chinese <https://cn.angie.software/angie/docs/>, Spanish <https://es.angie.software/angie/docs/>, or Portuguese <https://pt.angie.software/angie/docs/>__:

• Installation <https://en.angie.software/angie/docs/installation/>_ (ru <https://angie.software/angie/docs/installation/>, cn <https://cn.angie.software/angie/docs/installation/>, es <https://es.angie.software/angie/docs/installation/>, pt <https://pt.angie.software/angie/docs/installation/>)

• Runtime configuration <https://en.angie.software/angie/docs/configuration/>_ (ru <https://angie.software/angie/docs/configuration/>, cn <https://cn.angie.software/angie/docs/configuration/>, es <https://es.angie.software/angie/docs/configuration/>, pt <https://pt.angie.software/angie/docs/configuration/>)

• Troubleshooting and feedback channels <https://en.angie.software/angie/docs/troubleshooting/>_ (ru <https://angie.software/angie/docs/troubleshooting/>, cn <https://cn.angie.software/angie/docs/troubleshooting/>, es <https://es.angie.software/angie/docs/troubleshooting/>, pt <https://pt.angie.software/angie/docs/troubleshooting/>)

• Development and contribution <https://en.angie.software/angie/docs/development/>_ (ru <https://angie.software/angie/docs/development/>, cn <https://cn.angie.software/angie/docs/development/>, es <https://es.angie.software/angie/docs/development/>, pt <https://pt.angie.software/angie/docs/development/>)

Features

On top of all the capabilities of nginx 1.29 <https://nginx.org/en/CHANGES>_, Angie adds a number of its own advantages, including these:

• Supporting HTTP/3 <https://en.angie.software/angie/docs/configuration/modules/http/http_v3/>_ for client connections, as well as for proxied server <https://en.angie.software/angie/docs/configuration/modules/http/http_proxy/#proxy-http-version>_ connections, with the ability to independently use different protocol versions (HTTP/1.x, HTTP/2, HTTP/3) on opposite sides.

• Automatic HTTPS provisions TLS certificates using built-in ACME <https://en.angie.software/angie/docs/configuration/acme/>_ with HTTP, DNS, and ALPN challenge support.

• Simplifying configuration: the location directive can define several matching expressions at once, which enables combining <https://en.angie.software/angie/docs/configuration/modules/http/#combined-locations>_ blocks with shared settings.

• Exposing basic information about the web server, its configuration <https://en.angie.software/angie/docs/configuration/modules/http/http_api/#a-api-config-files>_, as well as metrics <https://en.angie.software/angie/docs/configuration/modules/http/http_api/#metrics>_ of proxied servers, client connections, shared memory zones, and many other things via a RESTful API <https://en.angie.software/angie/docs/configuration/modules/http/http_api/#a-api>_ interface in JSON format.

• Exporting statistics in Prometheus <https://en.angie.software/angie/docs/configuration/modules/http/http_prometheus/#prometheus>_ format with customizable templates <https://en.angie.software/angie/docs/configuration/modules/http/http_prometheus/#prometheus-template>_.

• Monitoring the server through the browser with the Console Light <https://en.angie.software/angie/docs/configuration/monitoring/>_ visual monitoring tool. See the online demo: https://console.angie.software/

• Dynamic updating of upstream groups based on events and labels from Docker containers <https://en.angie.software/angie/docs/configuration/modules/http/http_docker/#http-docker>_ (or similar tools like Podman) without server reload.

• Flushing the shared memory zone in proxy_cache_path <https://en.angie.software/angie/docs/configuration/modules/http/http_proxy/#proxy-cache-path>_ on disk preserves the cache index contents between restarts and updates, which eliminates the cache load delay and brings the server online even faster.

• Session binding <https://en.angie.software/angie/docs/configuration/modules/http/http_upstream/#u-sticky>_ mode, which directs all requests within one session to the same proxied server.

• Recommissioning upstream servers after a failure smoothly using the slow_start option of the server <https://en.angie.software/angie/docs/configuration/modules/http/http_upstream/#u-server>_ directive.

• PROXY Protocol V2 with the ability to pass arbitrary TLV values <https://en.angie.software/angie/docs/configuration/modules/stream/stream_proxy/#s-proxy-protocol-tlv>_.

• Limiting the MP4 file transfer rate <https://en.angie.software/angie/docs/configuration/modules/http/http_mp4/#mp4-limit-rate>_ proportionally to its bitrate, thus reducing the bandwidth load.

• Processing HEIC and AVIF formats and image conversion <https://en.angie.software/angie/docs/configuration/modules/http/http_image_filter/#id1>_.

• Extending authorization and balancing capabilities for the MQTT protocol with the mqtt_preread <https://en.angie.software/angie/docs/configuration/modules/stream/stream_mqtt_preread/#s-mqtt-preread>_ directive under stream.

• Informing balancing decisions with RDP protocol's session cookies via the rdp_preread <https://en.angie.software/angie/docs/configuration/modules/stream/stream_rdp_preread/#rdp-preread>_ directive under stream.

• Pre-built binary packages <https://en.angie.software/angie/docs/installation/oss_packages/#install-thirdpartymodules-oss>_ for many popular third-party modules.

• Server <https://en.angie.software/angie/docs/configuration/modules/http/http_ssl/#ssl-ntls>_- and client-side <https://en.angie.software/angie/docs/configuration/modules/http/http_proxy/#proxy-ssl-ntls> support for NTLS when using the TongSuo <https://github.com/Tongsuo-Project/Tongsuo> TLS library, enabled at build time <https://en.angie.software/angie/docs/installation/sourcebuild/#install-source-features>_.