Package Installation of Angie PRO#
To access the package repository, you need to sign a contract and purchase a license. For questions about licenses, contracts, and custom builds, contact:
+7 (495) 120 50 33
Then, configure the repository for your distro's package manager
to install and update Angie PRO
and the dynamic modules you need.
Finally, install the license file
and update the limits. Name Versions Architectures 9, 8 x86-64, arm64 3.21, 3.20, 3.19, 3.18 x86-64, arm64 10 x86-64, arm64 4.7 arm64 9 x86-64, arm64 12, 11 x86-64, arm64 14, 13 x86-64, arm64 9 x86-64 15 x86-64, arm64 9, 8 x86-64, arm64 8 x86-64 9, 8 x86-64, arm64 Chrome 12 x86-64, arm64 9 x86-64 24.04, 22.04, 20.04 x86-64, arm64 Create the Transfer the files you received with your license: File Type Original Name Where Certificate Private Key Hint If you have the license but not these files, email us at
. To add the repo,
create the following file named
Install the Angie PRO package: (Optional) Install any extra
packages you need: Start the service: To autostart Angie PRO after server reboot: Transfer the files you received with your license: File Type Original Name Where Certificate Private Key Hint If you have the license but not these files, email us at
. Install the prerequisites
for adding the Angie PRO repo: Download the public key of the Angie PRO repo
for package verification: Add the Angie PRO repo: Update the repo indexes: Install the Angie PRO package: (Optional) Install any extra
packages you need: Start the service: To autostart Angie PRO on server reboot: Create the Transfer the files you received with your license: File Type Original Name Where Certificate Private Key Hint If you have the license but not these files, email us at
. Download the public key of the Angie PRO repo
for package verification: Save the key's signature: Add the Angie PRO repo: Save an Update the repo indexes: Install the Angie PRO package: (Optional) Install any extra
packages you need: Start the service: To autostart Angie PRO on server reboot: Create the Transfer the files you received with your license: File Type Original Name Where Certificate Private Key Hint If you have the license but not these files, email us at
. Restrict the access to the directory and the files: Install the prerequisites
for adding the Angie PRO repo: Download the public key of the Angie PRO repo
for package verification: Add the Angie PRO repo: To configure the repo, create a file named
Update the repo indexes: (Optional) When running a Closed Software Environment
(CSE),
install the key package
for Angie PRO binary verification: Update the CSE: Then restart the server: Install the Angie PRO package: (Optional) Install any extra
packages you need: Create the Transfer the files you received with your license: File Type Original Name Where Certificate Private Key Hint If you have the license but not these files, email us at
. Restrict the access to the directory and the files: Install the prerequisites
for adding the Angie PRO repo: Download the public key of the Angie PRO repo
for package verification: Add the Angie PRO repo: To configure the repo, create a file named
Update the repo indexes: Install the Angie PRO package: (Optional) Install any extra
packages you need: To add the Angie PRO repo, create these directories: To configure the repo, create a file named
Download the public key of the Angie PRO repo
for package verification: Transfer the files you received with your license: File Type Original Name Where Certificate Private Key Hint If you have the license but not these files, email us at
. Add the certificate and the key to the package manager's configuration: Update the repo indexes: Install the Angie PRO package: (Optional) Install any extra
packages you need: Start the service: To autostart Angie PRO on server reboot: Create the Transfer the files you received with your license: File Type Original Name Where Certificate Private Key And bundle them into Hint If you have the license but not these files, email us at
. To add the repo, create a file named
Update the repo indexes: Install the Angie PRO package: (Optional) Install any extra
packages you need: Start the service: To autostart Angie PRO after server reboot: Besides the packages that provide the basic functionality,
we also publish a few extra packages,
both our own and built from curated third-party sources. Console Light is a lightweight, real-time monitoring interface for Angie PRO,
published as To extend the basic functionality of Angie PRO,
you can add various dynamic modules,
available as ready-made packages from our repository: Adds a filter to transform JPEG, GIF, PNG, and WebP images. Enables using njs (a JavaScript subset) in Angie configuration
in the Enables writing Adds a filter to transform XML responses with XSLT stylesheets. We also build and publish in our repository
the following third-party module packages: Adds client JWT authentication. Adds support for authentication against multiple LDAP servers. Adds PAM authentication. Adds SPNEGO, GSSAPI support. Enables Brotli for dynamic and static response compression. Enables purging FastCGI, proxy, SCGI, and uWSGI cache contents. Enables CGI. Extends WebDAV method support, adding PROPFIND and OPTIONS. Enables dynamically locking IPs and releasing them periodically. Enables Enhances the capabilities of the built-in
Memcached module. Enables capturing subrequest response bodies in variables. angie-pro-module-geoip2:
http_geoip2,
stream_geoip2 Enables geodata lookup in the MaxMind GeoIP2 database. Enables setting and clearing input and output headers. Enables Radius support. Enables variables created from key-value pairs. angie-pro-module-lua:
http_lua_module,
stream_lua_module Enable using Lua in Angie PRO configuration
in the Adds a connector that enables ModSecurity rules. Note The package needs
extra setup. Adds Nginx Development Kit (NDK) for module development. Enables sending telemetry data to an OpenTelemetry collector. Adds distributed tracing of Angie PRO requests via OpenTracing;
includes data export plugins for Zipkin and DataDog. Enables direct communication with PostgreSQL databases. Enables Redis 2.0 for HTTP upstreams. Enables RTMP for live streaming and video on demand. Adds various Enables regex string substitutions in the HTTP response body. Enables robot mitigation
using a cookie-based challenge-response mechanism. Decompresses responses with Adds the Enables repackaging .mp4 files for HLS, HDS, MSS, and DASH streaming. angie-pro-module-vts:
module-vts,
module-sts,
module-stream-sts Packs the three listed modules for traffic monitoring. Note Their respective template files are installed as follows: Enables packaging ZIP archives dynamically. Enables Zstandard compression. To use an installed module in the configuration,
load it with the load_module directive. To configure the license for Angie PRO: Save the license file as Verify the license is valid;
otherwise, check the details: Monitor the console and logs for any licensing issues.
If the license expires mid-operation,
Angie PRO periodically logs warnings indicating this.
Additionally, on reload, it reports configuration errors
if, for example, the number of worker processes
set forth in the license terms
is exceeded. Update After saving the license file,
update the settings according to your license terms, for example:Distros#
8
x86-64
1.8, 1.7
x86-64
7
x86-64, arm64
Fresh 12
x86-64Alma, CentOS, MSVSphere, Oracle, RED OS, Rocky, ROSA, SberLinux#
/etc/ssl/angie/
directory:$ sudo mkdir -p /etc/ssl/angie/
angie-repo.crt
/etc/ssl/angie/angie-repo.crt
angie-repo.key
/etc/ssl/angie/angie-repo.key
/etc/yum.repos.d/angie.repo
:[angie-pro]
name=Angie PRO repo
baseurl=https://download.angie.software/angie-pro/almalinux/$releasever/
sslclientcert=/etc/ssl/angie/angie-repo.crt
sslclientkey=/etc/ssl/angie/angie-repo.key
gpgcheck=1
enabled=1
gpgkey=https://angie.software/keys/angie-signing.gpg.asc
[angie-pro]
name=Angie PRO repo
baseurl=https://download.angie.software/angie-pro/centos/$releasever/
sslclientcert=/etc/ssl/angie/angie-repo.crt
sslclientkey=/etc/ssl/angie/angie-repo.key
gpgcheck=1
enabled=1
gpgkey=https://angie.software/keys/angie-signing.gpg.asc
[angie-pro]
name=Angie PRO repo
baseurl=https://download.angie.software/angie-pro/msvsphere/$releasever/
sslclientcert=/etc/ssl/angie/angie-repo.crt
sslclientkey=/etc/ssl/angie/angie-repo.key
gpgcheck=1
enabled=1
gpgkey=https://angie.software/keys/angie-signing.gpg.asc
[angie-pro]
name=Angie PRO repo
baseurl=https://download.angie.software/angie-pro/oracle/$releasever/
sslclientcert=/etc/ssl/angie/angie-repo.crt
sslclientkey=/etc/ssl/angie/angie-repo.key
gpgcheck=1
enabled=1
gpgkey=https://angie.software/keys/angie-signing.gpg.asc
[angie-pro]
name=Angie PRO repo
baseurl=https://download.angie.software/angie-pro/redos/$releasever/
sslclientcert=/etc/ssl/angie/angie-repo.crt
sslclientkey=/etc/ssl/angie/angie-repo.key
gpgcheck=1
enabled=1
gpgkey=https://angie.software/keys/angie-signing.gpg.asc
[angie-pro]
name=Angie PRO repo
baseurl=https://download.angie.software/angie-pro/rocky/$releasever/
sslclientcert=/etc/ssl/angie/angie-repo.crt
sslclientkey=/etc/ssl/angie/angie-repo.key
gpgcheck=1
enabled=1
gpgkey=https://angie.software/keys/angie-signing.gpg.asc
[angie-pro]
name=Angie PRO repo
baseurl=https://download.angie.software/angie-pro/rosa-chrome/$releasever/
sslclientcert=/etc/ssl/angie/angie-repo.crt
sslclientkey=/etc/ssl/angie/angie-repo.key
gpgcheck=1
enabled=1
gpgkey=https://angie.software/keys/angie-signing.gpg.asc
[angie-pro]
name=Angie PRO repo
baseurl=https://download.angie.software/angie-pro/rosa/$releasever/
sslclientcert=/etc/ssl/angie/angie-repo.crt
sslclientkey=/etc/ssl/angie/angie-repo.key
gpgcheck=1
enabled=1
gpgkey=https://angie.software/keys/angie-signing.gpg.asc
[angie-pro]
name=Angie PRO repo
baseurl=https://download.angie.software/angie-pro/sberlinux/$releasever/
sslclientcert=/etc/ssl/angie/angie-repo.crt
sslclientkey=/etc/ssl/angie/angie-repo.key
gpgcheck=1
enabled=1
gpgkey=https://angie.software/keys/angie-signing.gpg.asc
$ sudo yum install -y angie-pro
$ sudo yum install -y <PACKAGE NAME>
$ sudo systemctl start angie
$ sudo systemctl enable angie
Alpine#
angie-repo.crt
/etc/apk/cert.pem
angie-repo.key
/etc/apk/cert.key
$ sudo apk update
$ sudo apk add curl ca-certificates
$ sudo curl -o /etc/apk/keys/angie-signing.rsa \
https://angie.software/keys/angie-signing.rsa
$ echo "https://download.angie.software/angie-pro/alpine/v$(egrep -o \
'[0-9]+\.[0-9]+' /etc/alpine-release)/main" \
| sudo tee -a /etc/apk/repositories > /dev/null
$ sudo apk update
$ sudo apk add angie-pro
$ sudo apk add <PACKAGE NAME>
$ sudo service angie start
$ sudo rc-update add angie
ALT Linux#
/etc/ssl/angie
directory:$ sudo mkdir -p /etc/ssl/angie/
angie-repo.crt
/etc/ssl/angie/angie-repo.crt
angie-repo.key
/etc/ssl/angie/angie-repo.key
$ curl -o ~/angie-signing.gpg https://angie.software/keys/angie-signing.gpg && \
sudo gpg --no-default-keyring --keyring /usr/lib/alt-gpgkeys/pubring.gpg --import ~/angie-signing.gpg
$ echo 'simple-key "angie-pro" {
Fingerprint "EB8EAF3D4EF1B1ECF34865A2617AB978CB849A76";
Name "Angie PRO (Signing Key) <devops@tech.wbsrv.ru>";
}' | sudo tee /etc/apt/vendors.list.d/angie.list > /dev/null
$ echo "rpm [angie-pro] https://download.angie.software/angie-pro/altlinux/10/ $(uname -m) main" \
| sudo tee /etc/apt/sources.list.d/angie.list > /dev/null
$ echo "rpm [angie-pro] https://download.angie.software/angie-pro/altlinux-sp/10/ $(uname -m) main" \
| sudo tee /etc/apt/sources.list.d/angie.list > /dev/null
$ echo "rpm [angie-pro] https://download.angie.software/angie-pro/altlinux-sp/8/ $(uname -m) main" \
| sudo tee /etc/apt/sources.list.d/angie.list > /dev/null
apt
configuration file for the Angie PRO repo
as /etc/apt/apt.conf.d
:$ ( echo 'Acquire::https::Verify-Peer "true";';
echo 'Acquire::https::Verify-Host "true";';
echo 'Acquire::https::SslCert "/etc/ssl/angie/angie-repo.crt";';
echo 'Acquire::https::SslKey "/etc/ssl/angie/angie-repo.key";';
) | sudo tee -a /etc/apt/apt.conf >/dev/null
$ sudo apt-get update
$ sudo apt-get install -y angie-pro
$ sudo apt-get install -y <PACKAGE NAME>
$ sudo systemctl start angie
$ sudo systemctl enable angie
Astra SE#
/etc/ssl/angie/
directory:$ sudo mkdir -p /etc/ssl/angie/
angie-repo.crt
/etc/ssl/angie/angie-repo.crt
angie-repo.key
/etc/ssl/angie/angie-repo.key
$ sudo chown -R _apt:nogroup /etc/ssl/angie/
$ sudo apt-get update
$ sudo apt-get install -y apt-transport-https lsb-release \
ca-certificates curl gnupg2
$ sudo curl -o /etc/apt/trusted.gpg.d/angie-signing.gpg \
https://angie.software/keys/angie-signing.gpg
$ echo "deb https://download.angie.software/angie-pro/astra-se/$(egrep -o \
'[0-9]+\.[0-9]+' /etc/astra_version) unstable main" \
| sudo tee /etc/apt/sources.list.d/angie.list > /dev/null
/etc/apt/apt.conf.d/90download-angie
with the following contents:Acquire::https::download.angie.software::Verify-Peer "true";
Acquire::https::download.angie.software::Verify-Host "true";
Acquire::https::download.angie.software::SslCert "/etc/ssl/angie/angie-repo.crt";
Acquire::https::download.angie.software::SslKey "/etc/ssl/angie/angie-repo.key";
$ sudo apt-get update
$ sudo apt-get install -y angie-digsig-key
$ sudo update-initramfs -uk all
$ sudo shutdown -r now
$ sudo apt-get install -y angie-pro
$ sudo apt-get install -y <PACKAGE NAME>
Debian, Ubuntu#
/etc/ssl/angie/
directory:$ sudo mkdir -p /etc/ssl/angie/
angie-repo.crt
/etc/ssl/angie/angie-repo.crt
angie-repo.key
/etc/ssl/angie/angie-repo.key
$ sudo chown -R _apt:nogroup /etc/ssl/angie/
$ sudo apt-get update
$ sudo apt-get install -y apt-transport-https lsb-release \
ca-certificates curl gnupg2
$ sudo curl -o /etc/apt/trusted.gpg.d/angie-signing.gpg \
https://angie.software/keys/angie-signing.gpg
$ echo "deb https://download.angie.software/angie-pro/$(. /etc/os-release && echo "$ID/$VERSION_ID $VERSION_CODENAME") main" \
| sudo tee /etc/apt/sources.list.d/angie.list > /dev/null
/etc/apt/apt.conf.d/90download-angie
with the following contents:Acquire::https::download.angie.software::Verify-Peer "true";
Acquire::https::download.angie.software::Verify-Host "true";
Acquire::https::download.angie.software::SslCert "/etc/ssl/angie/angie-repo.crt";
Acquire::https::download.angie.software::SslKey "/etc/ssl/angie/angie-repo.key";
$ sudo apt-get update
$ sudo apt-get install -y angie-pro
$ sudo apt-get install -y <PACKAGE NAME>
FreeBSD#
$ sudo mkdir -p /usr/local/etc/pkg/angie/ /usr/local/etc/pkg/repos/
/usr/local/etc/pkg/repos/angie.conf
with the following contents:angie: {
url: "https://download.angie.software/angie-pro/freebsd/${VERSION_MAJOR}/${ARCH}",
signature_type: "pubkey",
pubkey: "/usr/local/etc/pkg/angie/angie-signing.rsa",
enabled: yes
}
$ sudo curl -o /usr/local/etc/pkg/angie/angie-signing.rsa \
https://angie.software/keys/angie-signing.rsa
angie-repo.crt
/usr/local/etc/pkg/angie/angie-repo.crt
angie-repo.key
/usr/local/etc/pkg/angie/angie-repo.key
$ echo '
PKG_ENV: {
SSL_CLIENT_CERT_FILE: "/usr/local/etc/pkg/angie/angie-repo.crt",
SSL_CLIENT_KEY_FILE: "/usr/local/etc/pkg/angie/angie-repo.key"
}' | sudo tee -a /usr/local/etc/pkg.conf > /dev/null
$ sudo pkg update
$ sudo pkg install -y angie-pro
$ sudo pkg install -y <PACKAGE NAME>
$ sudo service angie start
$ sudo sysrc angie_enable=YES
openSUSE#
/etc/ssl/angie
directory:$ sudo mkdir -p /etc/ssl/angie/
angie-repo.crt
/etc/ssl/angie/angie-repo.crt
angie-repo.key
/etc/ssl/angie/angie-repo.key
/etc/ssl/angie/angie-repo-bundle.crt
:$ cat /etc/ssl/angie/angie-repo.crt /etc/ssl/angie/angie-repo.key | \
sudo tee -a /etc/ssl/angie/angie-repo-bundle.crt > /dev/null
/etc/zypp/repos.d/angie.repo
with the following contents:[angie-pro]
enabled=1
autorefresh=1
baseurl=https://download.angie.software/angie-pro/opensuse/$releasever_major?ssl_clientcert=/etc/ssl/angie/angie-repo-bundle.crt&ssl_verify=peer
gpgcheck=1
gpgkey=https://angie.software/keys/angie-signing.gpg.asc
$ sudo zypper refresh
$ sudo zypper install -y angie-pro
$ sudo zypper install -y <PACKAGE NAME>
$ sudo systemctl start angie
$ sudo systemctl enable angie
Extras#
Console Light#
angie-pro-console-light
in our repositories.
It is installed in the same way as the angie
package in the steps above;
see the configuration steps in Console Light Web Monitoring Panel.Dynamic Modules#
http
and stream
contexts, respectively.location
and variable handlers in Perl,
and also invoking Perl from SSI.echo
, sleep
, time
, exec
,
and other shell-style commands in the configuration file.http
and stream
contexts, respectively.set_xxx
directives to the
Rewrite module.Content-Encoding: br
for clients that do not support the Brotli encoding method.multipart/form-data
encoding (RFC 1867) for file upload,
enabling resumable uploads./usr/share/angie-pro-module-vts/status.compress.html
/usr/share/angie-pro-module-vts/status.template.html
/usr/share/angie-pro-module-vts/stream/status.compress.html
/usr/share/angie-pro-module-vts/stream/status.template.html
License File#
/etc/angie/license.pem
,
setting the permissions you use for your
client certificates.$ sudo angie -t
angie: Valid license found:
angie: - owner: CN=Angie Client License
angie: - period: Jul 8 21:00:00 2024 GMT .. Jul 17 20:59:59 2024 GMT
angie:
angie: Limitations:
angie: - worker_processes_limit: 8
angie: - worker_connections_limit: 0
/etc/angie/angie.conf
;
after installation, it has two settings that limit the operation:worker_processes 1;
worker_connections 256;
worker_processes 8;
worker_connections 65535;