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:

• https://angie.software/

• +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.

Distros

Name	Versions	Architectures
AlmaLinux	9,   8	x86-64, arm64
Alpine	3.21,   3.20,   3.19,   3.18	x86-64, arm64
Alt	10 8	x86-64, arm64 x86-64
Astra SE	4.7 1.8, 1.7	arm64 x86-64
CentOS	9	x86-64, arm64
Debian	12,   11	x86-64, arm64
FreeBSD	14,   13	x86-64, arm64
MSVSphere	9	x86-64
openSUSE	15	x86-64, arm64
Oracle Linux	9,   8	x86-64, arm64
RED OS	8 7	x86-64 x86-64, arm64
Rocky Linux	9,   8	x86-64, arm64
ROSA	Chrome 12 Fresh 12	x86-64, arm64 x86-64
SberLinux	9	x86-64
Ubuntu	24.04,   22.04,   20.04	x86-64, arm64

Alma, CentOS, MSVSphere, Oracle, RED OS, Rocky, ROSA, SberLinux

1. Create the /etc/ssl/angie/ directory:

   $ sudo mkdir -p /etc/ssl/angie/
   

2. 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 .

3. To add the repo, create the following file named /etc/yum.repos.d/angie.repo:

   AlmaCentOSMSVSphereOracleRED OSRockyROSA ChromeROSA FreshSberLinux

   [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
   

4. Install the Angie PRO package:

   $ sudo yum install -y angie-pro
   

5. (Optional) Install any extra packages you need:

   $ sudo yum install -y <PACKAGE NAME>
   

6. Start the service:

   $ sudo systemctl start angie
   

7. To autostart Angie PRO after server reboot:

   $ sudo systemctl enable angie
   

Alpine

1. 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 .

2. Install the prerequisites for adding the Angie PRO repo:

   $ sudo apk update
   $ sudo apk add curl ca-certificates
   

3. 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
   

4. 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
   

5. Update the repo indexes:

   $ sudo apk update
   

6. Install the Angie PRO package:

   $ sudo apk add angie-pro
   

7. (Optional) Install any extra packages you need:

   $ sudo apk add <PACKAGE NAME>
   

8. Start the service:

   $ sudo service angie start
   

9. To autostart Angie PRO on server reboot:

   $ sudo rc-update add angie
   

ALT Linux

1. Create the /etc/ssl/angie directory:

   $ sudo mkdir -p /etc/ssl/angie/
   

2. 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 .

3. 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
   

4. Save the key's signature:

   $ 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
   

5. Add the Angie PRO repo:

   ALT 10ALT 10 SPALT 8 SP

   $ 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
   

6. 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
   

7. Update the repo indexes:

   $ sudo apt-get update
   

8. Install the Angie PRO package:

   $ sudo apt-get install -y angie-pro
   

9. (Optional) Install any extra packages you need:

   $ sudo apt-get install -y <PACKAGE NAME>
   

10. Start the service:

    $ sudo systemctl start angie
    

11. To autostart Angie PRO on server reboot:

    $ sudo systemctl enable angie
    

Astra SE

1. Create the /etc/ssl/angie/ directory:

   $ sudo mkdir -p /etc/ssl/angie/
   

2. 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 .

   Restrict the access to the directory and the files:

   $ sudo chown -R _apt:nogroup /etc/ssl/angie/
   

3. 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
   

4. 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
   

5. 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
   

6. 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";
   

7. Update the repo indexes:

   $ sudo apt-get update
   

8. (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
   

9. Install the Angie PRO package:

   $ sudo apt-get install -y angie-pro
   

10. (Optional) Install any extra packages you need:

    $ sudo apt-get install -y <PACKAGE NAME>
    

Debian, Ubuntu

1. Create the /etc/ssl/angie/ directory:

   $ sudo mkdir -p /etc/ssl/angie/
   

2. 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 .

   Restrict the access to the directory and the files:

   $ sudo chown -R _apt:nogroup /etc/ssl/angie/
   

3. 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
   

4. 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
   

5. 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
   

6. 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";
   

7. Update the repo indexes:

   $ sudo apt-get update
   

8. Install the Angie PRO package:

   $ sudo apt-get install -y angie-pro
   

9. (Optional) Install any extra packages you need:

   $ sudo apt-get install -y <PACKAGE NAME>
   

FreeBSD

1. To add the Angie PRO repo, create these directories:

   $ sudo mkdir -p /usr/local/etc/pkg/angie/ /usr/local/etc/pkg/repos/
   

2. 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
   }
   

3. 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
   

4. 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 .

5. 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
   

6. Update the repo indexes:

   $ sudo pkg update
   

7. Install the Angie PRO package:

   $ sudo pkg install -y angie-pro
   

8. (Optional) Install any extra packages you need:

   $ sudo pkg install -y <PACKAGE NAME>
   

9. Start the service:

   $ sudo service angie start
   

10. To autostart Angie PRO on server reboot:

    $ sudo sysrc angie_enable=YES
    

openSUSE

1. Create the /etc/ssl/angie directory:

   $ sudo mkdir -p /etc/ssl/angie/
   

2. 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 .

3. 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
   

4. Update the repo indexes:

   $ sudo zypper refresh
   

5. Install the Angie PRO package:

   $ sudo zypper install -y angie-pro
   

6. (Optional) Install any extra packages you need:

   $ sudo zypper install -y <PACKAGE NAME>
   

7. Start the service:

   $ sudo systemctl start angie
   

8. 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:

angie-pro-module-image-filter	Adds a filter to transform JPEG, GIF, PNG, and WebP images.
angie-pro-module-njs: HTTP JS module, streaming JS module	Enables using njs (a JavaScript subset) in Angie configuration in the http and stream contexts, respectively.
angie-pro-module-perl	Enables writing location and variable handlers in Perl, and also invoking Perl from SSI.
angie-pro-module-xslt	Adds a filter to transform XML responses with XSLT stylesheets.

To use an installed module in a configuration, load it using the load_module directive in the main context:

load_module modules/<module name>.so;

A wide range of third-party modules is also available.

License File

To configure the license for Angie PRO:

1. Save the license file as /etc/angie/license.pem, setting the permissions you use for your client certificates.

2. 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
   

3. 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.

4. Update /etc/angie/angie.conf; after installation, 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;