<!-- review: finished -->

<a id="oss-packages"></a>

# Instalação do Angie via Pacotes

Para instalar e atualizar o Angie
usando o gerenciador de pacotes da sua distribuição,
adicione e configure o repositório apropriado.

<a id="distributions"></a>

## Distribuições

| Nome                              | Versões                        | Arquiteturas                  |
|-----------------------------------|--------------------------------|-------------------------------|
| [AlmaLinux](#install-yum-oss)     | 10,  9,  8                     | x86-64, arm64                 |
| [Alpine](#install-alpine-oss)     | 3.23,  3.22,  3.21,  3.20      | x86-64, arm64                 |
| [Alt](#install-alt-oss)           | 11,  10  8                     | x86-64, arm64  x86-64         |
| [Astra SE](#install-astrase-oss)  | 4.7  1.8, 1.7                  | arm64  x86-64                 |
| [CentOS](#install-yum-oss)        | 10,  9                         | x86-64, arm64                 |
| [Debian](#install-deb-oss)        | 13,  12,  11                   | x86-64, arm64                 |
| [Fedora](#install-yum-oss)        | 44,  43                        | x86-64, arm64                 |
| [FreeBSD](#install-freebsd-oss)   | 15,  14,  13                   | x86-64, arm64                 |
| [MSVSphere](#install-yum-oss)     | 10,  9  8                      | x86-64, arm64  x86-64         |
| [openSUSE](#install-opensuse-oss) | 16,  15                        | x86-64, arm64                 |
| [Oracle Linux](#install-yum-oss)  | 10,  9,  8                     | x86-64, arm64                 |
| [OSNova](#install-osnova-oss)     | 3.3.0,  2.13                   | x86-64                        |
| [RED OS](#install-yum-oss)        | 8,  7                          | x86-64, arm64                 |
| [Rocky Linux](#install-yum-oss)   | 10,  9,  8                     | x86-64, arm64                 |
| [ROSA](#install-yum-oss)          | Chrome 13  Chrome 12  Fresh 12 | x86-64  x86-64, arm64  x86-64 |
| [SberLinux](#install-yum-oss)     | 9                              | x86-64                        |
| [Ubuntu](#install-deb-oss)        | 26.04,  24.04,  22.04          | x86-64, arm64                 |

<a id="test-builds"></a>

### Builds de Teste

Testamos e compilamos código do nosso repositório diariamente,
e estes
[builds noturnos](https://download.angie.software/angie-nightly/)
são adequados para explorar novos recursos antes dos lançamentos oficiais.

A versão dos builds noturnos sempre corresponde ao próximo lançamento.
O processo de nomenclatura e instalação é geralmente similar ao mostrado abaixo,
mas ao invés do prefixo de caminho `https://download.angie.software/angie/*`
use `https://download.angie.software/angie-nightly/*`.

<a id="install-yum-oss"></a>

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

1. Para adicionar o repositório, crie um arquivo chamado
   `/etc/yum.repos.d/angie.repo`
   com o seguinte conteúdo:

   Alma
   ```ini
   [angie]
   name=Angie repo
   baseurl=https://download.angie.software/angie/almalinux/$releasever/
   gpgcheck=1
   enabled=1
   gpgkey=https://angie.software/keys/angie-signing.gpg.asc
   ```

   CentOS
   ```ini
   [angie]
   name=Angie repo
   baseurl=https://download.angie.software/angie/centos/$releasever/
   gpgcheck=1
   enabled=1
   gpgkey=https://angie.software/keys/angie-signing.gpg.asc
   ```

   Fedora
   ```ini
   [angie]
   name=Angie repo
   baseurl=https://download.angie.software/angie/fedora/$releasever/
   gpgcheck=1
   enabled=1
   gpgkey=https://angie.software/keys/angie-signing.gpg.asc
   ```

   MSVSphere
   ```ini
   [angie]
   name=Angie repo
   baseurl=https://download.angie.software/angie/msvsphere/$releasever/
   gpgcheck=1
   enabled=1
   gpgkey=https://angie.software/keys/angie-signing.gpg.asc
   ```

   Oracle
   ```ini
   [angie]
   name=Angie repo
   baseurl=https://download.angie.software/angie/oracle/$releasever/
   gpgcheck=1
   enabled=1
   gpgkey=https://angie.software/keys/angie-signing.gpg.asc
   ```

   RED OS
   ```ini
   [angie]
   name=Angie repo
   baseurl=https://download.angie.software/angie/redos/$releasever/
   gpgcheck=1
   enabled=1
   gpgkey=https://angie.software/keys/angie-signing.gpg.asc
   ```

   Rocky
   ```ini
   [angie]
   name=Angie repo
   baseurl=https://download.angie.software/angie/rocky/$releasever/
   gpgcheck=1
   enabled=1
   gpgkey=https://angie.software/keys/angie-signing.gpg.asc
   ```

   ROSA Chrome
   ```ini
   [angie]
   name=Angie repo
   baseurl=https://download.angie.software/angie/rosa-chrome/$releasever/
   gpgcheck=1
   enabled=1
   gpgkey=https://angie.software/keys/angie-signing.gpg.asc
   priority=9
   ```

   ROSA Fresh
   ```ini
   [angie]
   name=Angie repo
   baseurl=https://download.angie.software/angie/rosa/$releasever/
   gpgcheck=1
   enabled=1
   gpgkey=https://angie.software/keys/angie-signing.gpg.asc
   priority=9
   ```

   SberLinux
   ```ini
   [angie]
   name=Angie repo
   baseurl=https://download.angie.software/angie/sberlinux/$releasever/
   gpgcheck=1
   enabled=1
   gpgkey=https://angie.software/keys/angie-signing.gpg.asc
   priority=9
   ```
2. Instale o pacote Angie:
   ```console
   $ sudo yum install -y angie
   $ # -- OU --
   $ sudo dnf install -y angie
   ```
3. (*Opcional*) Instale quaisquer pacotes [extras](#install-extras-oss)
   que você precisar:
   ```console
   $ sudo yum install -y <NOME DO PACOTE>
   $ # -- OU --
   $ sudo dnf install -y <NOME DO PACOTE>
   ```
4. Inicie o serviço:
   ```console
   $ sudo systemctl start angie
   ```
5. Para iniciar automaticamente o Angie após a reinicialização do servidor:
   ```console
   $ sudo systemctl enable angie
   ```

<a id="install-alpine-oss"></a>

### Alpine

1. Instale os pré-requisitos
   para adicionar o repositório do Angie:
   ```console
   $ sudo apk update
   $ sudo apk add curl ca-certificates
   ```
2. Baixe a chave pública do repositório do Angie
   para verificação de pacotes:
   ```console
   $ sudo curl -o /etc/apk/keys/angie-signing.rsa \
               https://angie.software/keys/angie-signing.rsa
   ```
3. Adicione o repositório do Angie:
   ```console
   $ echo "https://download.angie.software/angie/alpine/v$(egrep -o \
          '[0-9]+\.[0-9]+' /etc/alpine-release)/main" \
          | sudo tee -a /etc/apk/repositories > /dev/null
   ```
4. Atualize os índices do repositório:
   ```console
   $ sudo apk update
   ```
5. Instale o pacote Angie:
   ```console
   $ sudo apk add angie
   ```
6. (*Opcional*) Instale quaisquer pacotes [extras](#install-extras-oss)
   que você precisar:
   ```console
   $ sudo apk add <NOME DO PACOTE>
   ```
7. Inicie o serviço:
   ```console
   $ sudo service angie start
   ```
8. Para iniciar automaticamente o Angie após a reinicialização do servidor:
   ```console
   $ sudo rc-update add angie
   ```

<a id="install-alt-oss"></a>

### Alt

1. Crie o diretório `/etc/ssl/angie/`:
   ```console
   $ sudo mkdir -p /etc/ssl/angie/
   ```
2. Instale os pré-requisitos
   para adicionar o repositório do Angie:
   ```console
   $ sudo apt-get update
   $ sudo apt-get install -y curl apt-https
   ```
3. Baixe a chave pública do repositório do Angie
   para verificação de pacotes:
   ```console
   $ sudo curl -o /etc/ssl/angie/angie-signing.gpg \
         https://angie.software/keys/angie-signing.gpg
   ```
4. Importe a chave baixada para o chaveiro confiável:
   ```console
   $ sudo gpg --no-default-keyring \
         --keyring /usr/lib/alt-gpgkeys/pubring.gpg --import /etc/ssl/angie/angie-signing.gpg
   ```
5. Salve a assinatura da chave:
   ```sh
   $ echo 'simple-key "angie" {
             Fingerprint "EB8EAF3D4EF1B1ECF34865A2617AB978CB849A76";
             Name "Angie (Signing Key) <devops@tech.wbsrv.ru>";
     }' | sudo tee /etc/apt/vendors.list.d/angie.list > /dev/null
   ```
6. Adicione o repositório do Angie:

   Alt 11
   ```console
   $ echo "rpm [angie] https://download.angie.software/angie/altlinux/11/ $(uname -m) main" \
       | sudo tee /etc/apt/sources.list.d/angie.list > /dev/null
   ```

   Alt 10
   ```console
   $ echo "rpm [angie] https://download.angie.software/angie/altlinux/10/ $(uname -m) main" \
       | sudo tee /etc/apt/sources.list.d/angie.list > /dev/null
   ```

   Alt SP 10
   ```console
   $ echo "rpm [angie] https://download.angie.software/angie/altlinux-sp/10/ $(uname -m) main" \
       | sudo tee /etc/apt/sources.list.d/angie.list > /dev/null
   ```

   Alt SP 8
   ```console
   $ echo "rpm [angie] https://download.angie.software/angie/altlinux-sp/8/ $(uname -m) main" \
       | sudo tee /etc/apt/sources.list.d/angie.list > /dev/null
   ```
7. Atualize os índices do repositório:
   ```console
   $ sudo apt-get update
   ```
8. Instale o pacote do Angie:
   ```console
   $ sudo apt-get install -y angie
   ```
9. (*Opcional*) Instale quaisquer pacotes [extras](#install-extras-oss)
   que você precisar:
   ```console
   $ sudo apt-get install -y <PACKAGE NAME>
   ```
10. Inicie o serviço:
    ```console
    $ sudo systemctl start angie
    ```
11. Para inicializar automaticamente o Angie após a reinicialização do servidor:
    ```console
    $ sudo systemctl enable angie
    ```

<a id="install-astrase-oss"></a>

### Astra SE

1. Instale os pré-requisitos
   para adicionar o repositório do Angie:
   ```console
   $ sudo apt-get update
   $ sudo apt-get install -y ca-certificates curl lsb-release
   ```
2. Baixe a chave pública do repositório do Angie
   para verificação de pacotes:
   ```console
   $ sudo curl -o /etc/apt/trusted.gpg.d/angie-signing.gpg \
               https://angie.software/keys/angie-signing.gpg
   ```
3. Adicione o repositório do Angie:
   ```console
   $ echo "deb https://download.angie.software/angie/astra-se/$(egrep -o \
          '[0-9]+.[0-9]+' /etc/astra_version) unstable main" \
          | sudo tee /etc/apt/sources.list.d/angie.list > /dev/null
   ```
4. Atualize os índices do repositório:
   ```console
   $ sudo apt-get update
   ```
5. (*Opcional*) Ao executar um Ambiente de Software Fechado
   ([CSE](https://wiki.astralinux.ru/pages/viewpage.action?pageId=41190634)),
   instale o pacote de chave
   para verificação de binários do Angie:
   ```console
   $ sudo apt-get install -y angie-digsig-key
   ```

   Atualize o CSE:
   ```console
   $ sudo update-initramfs -uk all
   ```

   Em seguida, **reinicie o servidor**:
   ```console
   $ sudo shutdown -r now
   ```
6. Instale o pacote do Angie:
   ```console
   $ sudo apt-get install -y angie
   ```
7. (*Opcional*) Instale quaisquer pacotes [extras](#install-extras-oss)
   que você precisar:
   ```console
   $ sudo apt-get install -y <PACKAGE NAME>
   ```

<a id="install-deb-oss"></a>

### Debian, Ubuntu

1. Instale os pré-requisitos
   para adicionar o repositório do Angie:
   ```console
   $ sudo apt-get update
   $ sudo apt-get install -y ca-certificates curl
   ```
2. Baixe a chave pública do repositório do Angie
   para verificação de pacotes:
   ```console
   $ sudo curl -o /etc/apt/trusted.gpg.d/angie-signing.gpg \
               https://angie.software/keys/angie-signing.gpg
   ```
3. Adicione o repositório do Angie:
   ```console
   $ echo "deb https://download.angie.software/angie/$(. /etc/os-release && echo "$ID/$VERSION_ID $VERSION_CODENAME") main" \
       | sudo tee /etc/apt/sources.list.d/angie.list > /dev/null
   ```
4. Atualize os índices do repositório:
   ```console
   $ sudo apt-get update
   ```
5. Instale o pacote do Angie:
   ```console
   $ sudo apt-get install -y angie
   ```
6. (*Opcional*) Instale quaisquer pacotes [extras](#install-extras-oss)
   que você precisar:
   ```console
   $ sudo apt-get install -y <PACKAGE NAME>
   ```

<a id="install-osnova-oss"></a>

### OSNova

1. Instale os pré-requisitos
   para adicionar o repositório do Angie:
   ```console
   $ sudo apt-get update
   $ sudo apt-get install -y ca-certificates curl
   ```
2. Baixe a chave pública do repositório do Angie
   para verificação de pacotes:
   ```console
   $ sudo curl -o /etc/apt/trusted.gpg.d/angie-signing.gpg \
               https://angie.software/keys/angie-signing.gpg
   ```
3. Adicione o repositório do Angie:
   ```console
   $ echo "deb https://download.angie.software/angie/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. Atualize os índices do repositório:
   ```console
   $ sudo apt-get update
   ```
5. Instale o pacote do Angie:
   ```console
   $ sudo apt-get install -y angie
   ```
6. (*Opcional*) Instale quaisquer pacotes [extras](#install-extras-oss)
   que você precisar:
   ```console
   $ sudo apt-get install -y <PACKAGE NAME>
   ```

<a id="install-freebsd-oss"></a>

### FreeBSD

1. Para adicionar o repositório do Angie, crie os diretórios:
   ```console
   $ sudo mkdir -p /usr/local/etc/pkg/angie/ /usr/local/etc/pkg/repos/
   ```
2. Para configurar o repositório, crie um arquivo chamado
   `/usr/local/etc/pkg/repos/angie.conf`
   com o seguinte conteúdo:
   ```console
   angie: {
      url: "https://download.angie.software/angie/freebsd/${VERSION_MAJOR}/${ARCH}",
      signature_type: "pubkey",
      pubkey: "/usr/local/etc/pkg/angie/angie-signing.rsa",
      enabled: yes
   }
   ```
3. Baixe a chave pública do repositório do Angie
   para verificação de pacotes:
   ```console
   $ sudo curl -o /usr/local/etc/pkg/angie/angie-signing.rsa \
               https://angie.software/keys/angie-signing.rsa
   ```
4. Atualize os índices do repositório:
   ```console
   $ sudo pkg update
   ```
5. Instale o pacote do Angie:
   ```console
   $ sudo pkg install -r angie -y angie
   ```
6. (*Opcional*) Instale quaisquer pacotes [extras](#install-extras-oss)
   que você precisar:
   ```console
   $ sudo pkg install -r angie -y <PACKAGE NAME>
   ```
7. Inicie o serviço:
   ```console
   $ sudo service angie start
   ```
8. Para inicializar automaticamente o Angie após a reinicialização do servidor:
   ```console
   $ sudo sysrc angie_enable=YES
   ```

#### NOTE
Como o gerenciador de pacotes do FreeBSD pode determinar incorretamente a versão mais recente,
use a seguinte abordagem para atualizar pacotes já instalados:

```console
$ sudo pkg upgrade `pkg search -r angie angie-[0-9] | sort -Vr | head -1 | awk {'print $1'}`
```

<a id="install-opensuse-oss"></a>

### openSUSE

1. Para adicionar o repositório, crie um arquivo chamado
   `/etc/zypp/repos.d/angie.repo`
   com o seguinte conteúdo:
   ```ini
   [angie]
   name=Angie repo
   baseurl=https://download.angie.software/angie/opensuse/$releasever_major/
   gpgcheck=1
   enabled=1
   gpgkey=https://angie.software/keys/angie-signing.gpg.asc
   ```
2. Atualize os índices do repositório:
   ```console
   $ sudo zypper refresh
   ```
3. Instale o pacote do Angie:
   ```console
   $ sudo zypper install -y angie
   ```
4. (*Opcional*) Instale quaisquer pacotes [extras](#install-extras-oss)
   que você precisar:
   ```console
   $ sudo zypper install -y <PACKAGE NAME>
   ```
5. Inicie o serviço:
   ```console
   $ sudo systemctl start angie
   ```
6. Para inicializar automaticamente o Angie após a reinicialização do servidor:
   ```console
   $ sudo systemctl enable angie
   ```

<a id="install-extras-oss"></a>

## Extras

Além dos pacotes que fornecem a funcionalidade básica,
também publicamos alguns pacotes extras,
tanto nossos próprios quanto construídos a partir de fontes de terceiros selecionadas.

<a id="install-console-light-oss"></a>

### Painel Web Console Light

Console Light é um painel web leve de monitoramento para o Angie,
publicado como `angie-console-light` em nossos repositórios.
É instalado da mesma forma que o pacote `angie` nos passos acima;
veja os passos de configuração em [Painel Web de Monitoramento Console Light](https://pt.angie.software//angie/docs/configuration/monitoring.md#monitoring).

<a id="install-dynamicmodules-oss"></a>

### Módulos Dinâmicos

Para estender a funcionalidade básica do Angie,
você pode adicionar vários módulos dinâmicos.
Os módulos podem ser [construídos a partir do código-fonte](https://pt.angie.software//angie/docs/installation/sourcebuild.md#sourcebuild)
contra uma versão correspondente do Angie,
mas é mais fácil obtê-los como pacotes prontos do nosso repositório:

| [angie-module-image-filter](https://pt.angie.software//angie/docs/configuration/modules/http/http_image_filter.md#http-image-filter)                                                                                                     | Adiciona transformações para imagens JPEG, GIF, PNG e WebP.                                                                               |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------|
| angie-module-njs:<br/>[JS](https://pt.angie.software//angie/docs/installation/external-modules/http_js.md#http-js) (HTTP),<br/>[JS](https://pt.angie.software//angie/docs/installation/external-modules/stream_js.md#stream-js) (stream) | Permite usar njs (um subconjunto de JavaScript) na configuração do Angie<br/>nos contextos `http` e `stream`, respectivamente.            |
| [angie-module-perl](https://pt.angie.software//angie/docs/configuration/modules/http/http_perl.md#http-perl)                                                                                                                             | Permite escrever manipuladores de `location` e variáveis em Perl,<br/>e também invocar Perl a partir de SSI.                              |
| [angie-module-wamr](https://pt.angie.software//angie/docs/configuration/modules/wasm/wasm_wamr.md#wasm-wamr)                                                                                                                             | Permite integração com [WebAssembly Micro Runtime](https://github.com/bytecodealliance/wasm-micro-runtime)<br/>para executar código WASM. |
| [angie-module-wasm](https://pt.angie.software//angie/docs/configuration/modules/wasm/index.md#wasm-core)                                                                                                                                 | Adiciona suporte básico a WASM.                                                                                                           |
| [angie-module-wasmtime](https://pt.angie.software//angie/docs/configuration/modules/wasm/wasm_wasmtime.md#wasm-wasmtime)                                                                                                                 | Permite integração com o runtime [Wasmtime](https://wasmtime.dev/)<br/>para executar código WASM.                                         |
| [angie-module-xslt](https://pt.angie.software//angie/docs/configuration/modules/http/http_xslt.md#http-xslt)                                                                                                                             | Adiciona um filtro para transformar respostas XML com folhas de estilo XSLT.                                                              |

Para usar um módulo instalado em uma [configuração](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile),
carregue-o usando a diretiva [load_module](https://pt.angie.software//angie/docs/configuration/modules/core.md#load-module) no contexto `main`:

```nginx
load_module modules/<module name>.so;
```

Uma ampla gama de [módulos de terceiros](https://pt.angie.software//angie/docs/installation/external-modules/index.md#install-thirdpartymodules)
também está disponível.
