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 965 312-44-76
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.
Distros#
Name |
Versions |
Architectures |
---|---|---|
9, 8 |
x86-64, arm64 |
|
3.20, 3.19, 3.18, 3.17 |
x86-64, arm64 |
|
10 |
x86-64, arm64 |
|
4.7 |
arm64 |
|
9 7 |
x86-64, arm64 |
|
12, 11, 10 |
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 |
|
24.04, 22.04, 20.04 |
x86-64, arm64 |
Alma, CentOS, MSVSphere, Oracle, RED OS, Rocky, ROSA#
Create the /etc/ssl/angie directory:
$ sudo mkdir -p /etc/ssl/angie/
Transfer the files you received with your license:
File Type
Original Name
Where
Certificate
angie-repo.crt
/etc/ssl/angie/angie-repo.crt
Private Key
angie-repo.key
/etc/ssl/angie/angie-repo.key
Hint
If you have the license but not these files, email us at support@angie.software.
To add the repo, create the following file named /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
Install the Angie PRO package:
$ sudo yum install -y angie-pro
(Optional) Install any extra packages you need:
$ sudo yum install -y <PACKAGE NAME>
Start the service:
$ sudo systemctl start angie
To autostart Angie PRO after server reboot:
$ sudo systemctl enable angie
Alpine#
Transfer the files you received with your license:
File Type
Original Name
Where
Certificate
angie-repo.crt
/etc/apk/cert.pem
Private Key
angie-repo.key
/etc/apk/cert.key
Hint
If you have the license but not these files, email us at support@angie.software.
Install the prerequisites for adding the Angie PRO repo:
$ sudo apk update $ sudo apk add curl ca-certificates
Download the public key of the Angie PRO repo for package verification:
$ sudo curl -o /etc/apk/keys/angie-signing.rsa \ https://angie.software/keys/angie-signing.rsa
Add the Angie PRO repo:
$ 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
Update the repo indexes:
$ sudo apk update
Install the Angie PRO package:
$ sudo apk add angie-pro
(Optional) Install any extra packages you need:
$ sudo apk add <PACKAGE NAME>
Start the service:
$ sudo service angie start
To autostart Angie PRO on server reboot:
$ sudo rc-update add angie
ALT Linux#
Create the
/etc/ssl/angie
directory:$ sudo mkdir -p /etc/ssl/angie/
Transfer the files you received with your license:
File Type
Original Name
Where
Certificate
angie-repo.crt
/etc/ssl/angie/angie-repo.crt
Private Key
angie-repo.key
/etc/ssl/angie/angie-repo.key
Hint
If you have the license but not these files, email us at support@angie.software.
Download the public key of the Angie PRO repo for package verification:
$ 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
Save the key’s signature:
$ echo 'simple-key "angie" { Fingerprint "EB8EAF3D4EF1B1ECF34865A2617AB978CB849A76"; Name "Angie PRO (Signing Key) <devops@tech.wbsrv.ru>"; }' | sudo tee /etc/apt/vendors.list.d/angie.list > /dev/null
Add the Angie PRO repo:
$ 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
Save an
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
Update the repo indexes:
$ sudo apt-get update
Install the Angie PRO package:
$ sudo apt-get install -y angie-pro
(Optional) Install any extra packages you need:
$ sudo apt-get install -y <PACKAGE NAME>
Start the service:
$ sudo systemctl start angie
To autostart Angie PRO on server reboot:
$ sudo systemctl enable angie
Astra SE#
Create the /etc/ssl/angie/ directory:
$ sudo mkdir -p /etc/ssl/angie/
Transfer the files you received with your license:
File Type
Original Name
Where
Certificate
angie-repo.crt
/etc/ssl/angie/angie-repo.crt
Private Key
angie-repo.key
/etc/ssl/angie/angie-repo.key
Hint
If you have the license but not these files, email us at support@angie.software.
Restrict the access to the directory and the files:
$ sudo chown -R _apt:nogroup /etc/ssl/angie/
Install the prerequisites for adding the Angie PRO repo:
$ sudo apt-get update $ sudo apt-get install -y apt-transport-https lsb-release \ ca-certificates curl gnupg2
Download the public key of the Angie PRO repo for package verification:
$ sudo curl -o /etc/apt/trusted.gpg.d/angie-signing.gpg \ https://angie.software/keys/angie-signing.gpg
Add the Angie PRO repo:
$ 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
To configure the repo, create a file named /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";
Update the repo indexes:
$ sudo apt-get update
(Optional) When running a Closed Software Environment (CSE), install the key package for Angie PRO binary verification:
$ sudo apt-get install -y angie-digsig-key
Update the CSE:
$ sudo update-initramfs -uk all
Then restart the server:
$ sudo shutdown -r now
Install the Angie PRO package:
$ sudo apt-get install -y angie-pro
(Optional) Install any extra packages you need:
$ sudo apt-get install -y <PACKAGE NAME>
Debian, Ubuntu#
Create the /etc/ssl/angie/ directory:
$ sudo mkdir -p /etc/ssl/angie/
Transfer the files you received with your license:
File Type
Original Name
Where
Certificate
angie-repo.crt
/etc/ssl/angie/angie-repo.crt
Private Key
angie-repo.key
/etc/ssl/angie/angie-repo.key
Hint
If you have the license but not these files, email us at support@angie.software.
Restrict the access to the directory and the files:
$ sudo chown -R _apt:nogroup /etc/ssl/angie/
Install the prerequisites for adding the Angie PRO repo:
$ sudo apt-get update $ sudo apt-get install -y apt-transport-https lsb-release \ ca-certificates curl gnupg2
Download the public key of the Angie PRO repo for package verification:
$ sudo curl -o /etc/apt/trusted.gpg.d/angie-signing.gpg \ https://angie.software/keys/angie-signing.gpg
Add the Angie PRO repo:
$ 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
To configure the repo, create a file named /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";
Update the repo indexes:
$ sudo apt-get update
Install the Angie PRO package:
$ sudo apt-get install -y angie-pro
(Optional) Install any extra packages you need:
$ sudo apt-get install -y <PACKAGE NAME>
FreeBSD#
To add the Angie PRO repo, create these directories:
$ sudo mkdir -p /usr/local/etc/pkg/angie/ /usr/local/etc/pkg/repos/
To configure the repo, create a file named /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 }
Download the public key of the Angie PRO repo for package verification:
$ sudo curl -o /usr/local/etc/pkg/angie/angie-signing.rsa \ https://angie.software/keys/angie-signing.rsa
Transfer the files you received with your license:
File Type
Original Name
Where
Certificate
angie-repo.crt
/usr/local/etc/pkg/angie/angie-repo.crt
Private Key
angie-repo.key
/usr/local/etc/pkg/angie/angie-repo.key
Hint
If you have the license but not these files, email us at support@angie.software.
Add the certificate and the key to the package manager’s configuration:
$ 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
Update the repo indexes:
$ sudo pkg update
Install the Angie PRO package:
$ sudo pkg install -y angie-pro
(Optional) Install any extra packages you need:
$ sudo pkg install -y <PACKAGE NAME>
Start the service:
$ sudo service angie start
To autostart Angie PRO on server reboot:
$ sudo sysrc angie_enable=YES
openSUSE#
Create the
/etc/ssl/angie
directory:$ sudo mkdir -p /etc/ssl/angie/
Transfer the files you received with your license:
File Type
Original Name
Where
Certificate
angie-repo.crt
/etc/ssl/angie/angie-repo.crt
Private Key
angie-repo.key
/etc/ssl/angie/angie-repo.key
And bundle them into
/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
Hint
If you have the license but not these files, email us at support@angie.software.
To add the repo, create a file named /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
Update the repo indexes:
$ sudo zypper refresh
Install the Angie PRO package:
$ sudo zypper install -y angie-pro
(Optional) Install any extra packages you need:
$ sudo zypper install -y <PACKAGE NAME>
Start the service:
$ sudo systemctl start angie
To autostart Angie PRO after server reboot:
$ sudo systemctl enable angie
Extras#
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#
Console Light is a lightweight, real-time monitoring interface for Angie PRO,
published as 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#
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 SPNEGO, GSSAPI support. |
|
Enables Brotli for dynamic and static response compression. |
|
Enables purging FastCGI, proxy, SCGI, and uWSGI cache contents. |
|
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 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. |
|
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: /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
|
Enables packaging ZIP archives dynamically. |
|
Enables Zstandard compression. |
To use an installed module in the configuration, load it with the load_module directive.
License File#
To configure the license for Angie PRO:
Save the license file as
/etc/angie/license.pem
, setting the permissions you use for your client certificates.Verify the license is valid; otherwise, check the details:
$ 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
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
/etc/angie/angie.conf
; after instalation, it has two settings that limit the operation:worker_processes 1; worker_connections 256;
After saving the license file, update the settings according to your license terms, for example:
worker_processes 8; worker_connections 65535;