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 remove the restrictions.

Distributions

Name	Versions	Architectures
AlmaLinux	9,   8	x86-64, arm64
Alpine	3.22,   3.21,   3.20,   3.19	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
OSNova	3.3.0,   2.13	x86-64
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 repository, create the file /etc/yum.repos.d/angie.repo with the following content:

   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 automatically start 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 helper packages for adding the Angie PRO repository:

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

3. Download the public key of the Angie PRO repository for package verification:

   $ sudo curl -o /etc/apk/keys/angie-signing.rsa \
               https://angie.software/keys/angie-signing.rsa
   

4. Add the Angie PRO repository:

   $ 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 repository 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 automatically start Angie PRO after server reboot:

   $ sudo rc-update add angie
   

Alt

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 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 SP 10Alt SP 8

   $ 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. Create the Angie PRO repo apt configuration file in /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 after 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>
   

OSNova

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

   $ sudo apt-get update
   $ sudo apt-get install -y ca-certificates curl
   

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

3. Add the Angie PRO repo:

   $ echo "deb https://download.angie.software/angie-pro/osnova/$(egrep -o \
          '[0-9]*' /etc/osnova_version | head -1) \
          $(. /etc/os-release && echo "$VERSION_CODENAME") main" \
          | sudo tee /etc/apt/sources.list.d/angie.list > /dev/null
   

4. Update the repo indexes:

   $ sudo apt-get update
   

5. Install the Angie PRO package:

   $ sudo apt-get install -y angie
   

6. (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 after server reboot:

    $ sudo sysrc angie_enable=YES
    

openSUSE

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

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

2. Move the files 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

   Then combine them into a bundle /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 don't have these files but have a license, contact support: .

3. To add the repository, create the file /etc/zypp/repos.d/angie.repo with the following content:

   [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 repository indexes:

   $ sudo zypper refresh
   

5. Install the Angie PRO package:

   $ sudo zypper install -y angie-pro
   

6. (Optional) Install the packages for any extras you need:

   $ sudo zypper install -y <PACKAGE NAME>
   

7. Start the service:

   $ sudo systemctl start angie
   

8. To automatically start Angie PRO after server reboot:

   $ sudo systemctl enable angie
   

Extras

In addition to packages that provide core functionality, we also publish several additional packages, both our own and from selected third-party sources.

Console Light Web Panel

Console Light is a lightweight monitoring web panel for Angie PRO, published in our repositories as the angie-pro-console-light package. It's installed the same way as the angie package in the instructions above; for configuration instructions, see the Console Light Web Monitoring Panel section.

Dynamic Modules

To extend the basic functionality of Angie PRO, you can add various dynamic modules. You can get them as ready-made packages from our repository:

angie-pro-module-image-filter	Adds image transformations for JPEG, GIF, PNG, and WebP formats.
angie-pro-module-njs: JS (HTTP), JS (stream)	Allow using the njs language (a subset of JavaScript) in Angie PRO configuration in http and stream contexts respectively.
angie-pro-module-perl	Allows writing location and variable handlers in Perl, as well as calling Perl from SSI.
angie-pro-module-xslt	Adds a filter that transforms XML responses using XSLT templates.

To apply an installed module in your 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 same 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 during operation, Angie PRO periodically issues corresponding warnings. Additionally, on reload, configuration error messages will appear if, for example, the number of worker processes specified in the license terms is exceeded.

4. Modify the /etc/angie/angie.conf file; after installation, two parameters in it limit operation:

   worker_processes 1;
   worker_connections 256;
   

   After saving the license file, change them according to your license terms, for example:

   worker_processes 8;
   worker_connections 65535;