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
Once you have obtained a license, add and configure the appropriate repository to install and update Angie PRO using your distribution’s package manager:
Distro |
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 |
|
15 |
x86-64, arm64 |
|
9, 8 |
x86-64, arm64 |
|
8 |
x86-64 |
|
9, 8 |
x86-64, arm64 |
|
Хром 12 |
x86-64, arm64 |
|
24.04, 22.04, 20.04 |
x86-64, arm64 |
Alma, CentOS, 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/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 the dynamic module 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 the dynamic module 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 the dynamic module 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 the dynamic module 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 the dynamic module 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 the dynamic module 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 the dynamic module 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
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. |
|
angie-pro-module-njs: http_js_module, stream_js_module |
Enable using njs (a JavaScript subset) in Angie PRO configuration in the http and stream contexts, respectively. |
Enables writing location and variable handlers in Perl, and also invoking Perl from SSI. |
|
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. |
|
Used to dynamically lock IPs and release them periodically. |
|
Enables echo, sleep, time, exec, and other shell-style commands in the configuration file. |
|
Enhances the capabilities of the built-in http_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 http and stream contexts, respectively. |
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 set_xxx directives to the rewrite module. |
|
Enables regex string substitutions in the HTTP response body. |
|
Enables robot mitigation using a cookie-based challenge-response mechanism. |
|
Adds the multipart/form-data encoding (RFC 1867) for file upload, enabling resumable uploads. |
|
Enables repackaging .mp4 files for HLS, HDS, MSS, and DASH streaming. |
|
angie-pro-module-vts: module-vts, module-sts, module-stream-vts |
Packs the three listed modules that monitor traffic status. 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 assembling ZIP archives dynamically. |
|
Enables Zstandard compression. |
To use an installed module in the configuration, load it with the load_module directive.