<!-- review: finished -->

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

# Instalación de Angie mediante paquetes

Para instalar y actualizar Angie
utilizando el gestor de paquetes de su distribución,
añada y configure el repositorio correspondiente.

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

## Distribuciones

| Nombre                            | Versiones                      | Arquitecturas                 |
|-----------------------------------|--------------------------------|-------------------------------|
| [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>

### Compilaciones de prueba

Probamos y compilamos código de nuestro repositorio diariamente,
y estas
[compilaciones nocturnas](https://download.angie.software/angie-nightly/)
son adecuadas para explorar nuevas funcionalidades antes de los lanzamientos oficiales.

La versión de las compilaciones nocturnas siempre corresponde al próximo lanzamiento.
El proceso de nomenclatura e instalación es generalmente similar a lo que se muestra a continuación,
pero en lugar del prefijo de ruta `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 añadir el repositorio, cree un archivo llamado
   `/etc/yum.repos.d/angie.repo`
   con el siguiente contenido:

   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 el paquete Angie:
   ```console
   $ sudo yum install -y angie
   $ # -- OR --
   $ sudo dnf install -y angie
   ```
3. (*Opcional*) Instale cualquier paquete [adicional](#install-extras-oss)
   que necesite:
   ```console
   $ sudo yum install -y <NOMBRE DEL PAQUETE>
   $ # -- OR --
   $ sudo dnf install -y <NOMBRE DEL PAQUETE>
   ```
4. Inicie el servicio:
   ```console
   $ sudo systemctl start angie
   ```
5. Para iniciar automáticamente Angie después del reinicio del servidor:
   ```console
   $ sudo systemctl enable angie
   ```

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

### Alpine

1. Instale los requisitos previos
   para añadir el repositorio de Angie:
   ```console
   $ sudo apk update
   $ sudo apk add curl ca-certificates
   ```
2. Descargue la clave pública del repositorio de Angie
   para la verificación de paquetes:
   ```console
   $ sudo curl -o /etc/apk/keys/angie-signing.rsa \
               https://angie.software/keys/angie-signing.rsa
   ```
3. Añada el repositorio de 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. Actualice los índices del repositorio:
   ```console
   $ sudo apk update
   ```
5. Instale el paquete Angie:
   ```console
   $ sudo apk add angie
   ```
6. (*Opcional*) Instale cualquier paquete [adicional](#install-extras-oss)
   que necesite:
   ```console
   $ sudo apk add <NOMBRE DEL PAQUETE>
   ```
7. Inicie el servicio:
   ```console
   $ sudo service angie start
   ```
8. Para iniciar automáticamente Angie después del reinicio del servidor:
   ```console
   $ sudo rc-update add angie
   ```

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

### Alt

1. Cree el directorio `/etc/ssl/angie/`:
   ```console
   $ sudo mkdir -p /etc/ssl/angie/
   ```
2. Instale los requisitos previos
   para añadir el repositorio de Angie:
   ```console
   $ sudo apt-get update
   $ sudo apt-get install -y curl apt-https
   ```
3. Descargue la clave pública del repositorio de Angie
   para la verificación de paquetes:
   ```console
   $ sudo curl -o /etc/ssl/angie/angie-signing.gpg \
         https://angie.software/keys/angie-signing.gpg
   ```
4. Importe la clave descargada en el anillo de claves de confianza:
   ```console
   $ sudo gpg --no-default-keyring \
         --keyring /usr/lib/alt-gpgkeys/pubring.gpg --import /etc/ssl/angie/angie-signing.gpg
   ```
5. Guarde la firma de la clave:
   ```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. Añada el repositorio de 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. Actualice los índices del repositorio:
   ```console
   $ sudo apt-get update
   ```
8. Instale el paquete de Angie:
   ```console
   $ sudo apt-get install -y angie
   ```
9. (*Opcional*) Instale cualquier paquete [extra](#install-extras-oss)
   que necesite:
   ```console
   $ sudo apt-get install -y <NOMBRE DEL PAQUETE>
   ```
10. Inicie el servicio:
    ```console
    $ sudo systemctl start angie
    ```
11. Para iniciar automáticamente Angie después de reiniciar el servidor:
    ```console
    $ sudo systemctl enable angie
    ```

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

### Astra SE

1. Instale los requisitos previos
   para añadir el repositorio de Angie:
   ```console
   $ sudo apt-get update
   $ sudo apt-get install -y ca-certificates curl lsb-release
   ```
2. Descargue la clave pública del repositorio de Angie
   para la verificación de paquetes:
   ```console
   $ sudo curl -o /etc/apt/trusted.gpg.d/angie-signing.gpg \
               https://angie.software/keys/angie-signing.gpg
   ```
3. Añada el repositorio de 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. Actualice los índices del repositorio:
   ```console
   $ sudo apt-get update
   ```
5. (*Opcional*) Cuando se ejecuta en un Entorno de Software Cerrado
   ([CSE](https://wiki.astralinux.ru/pages/viewpage.action?pageId=41190634)),
   instale el paquete de clave
   para la verificación binaria de Angie:
   ```console
   $ sudo apt-get install -y angie-digsig-key
   ```

   Actualice el CSE:
   ```console
   $ sudo update-initramfs -uk all
   ```

   Luego **reinicie el servidor**:
   ```console
   $ sudo shutdown -r now
   ```
6. Instale el paquete de Angie:
   ```console
   $ sudo apt-get install -y angie
   ```
7. (*Opcional*) Instale cualquier paquete [extra](#install-extras-oss)
   que necesite:
   ```console
   $ sudo apt-get install -y <NOMBRE DEL PAQUETE>
   ```

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

### Debian, Ubuntu

1. Instale los requisitos previos
   para añadir el repositorio de Angie:
   ```console
   $ sudo apt-get update
   $ sudo apt-get install -y ca-certificates curl
   ```
2. Descargue la clave pública del repositorio de Angie
   para la verificación de paquetes:
   ```console
   $ sudo curl -o /etc/apt/trusted.gpg.d/angie-signing.gpg \
               https://angie.software/keys/angie-signing.gpg
   ```
3. Añada el repositorio de 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. Actualice los índices del repositorio:
   ```console
   $ sudo apt-get update
   ```
5. Instale el paquete de Angie:
   ```console
   $ sudo apt-get install -y angie
   ```
6. (*Opcional*) Instale cualquier paquete [extra](#install-extras-oss)
   que necesite:
   ```console
   $ sudo apt-get install -y <NOMBRE DEL PAQUETE>
   ```

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

### OSNova

1. Instale los requisitos previos
   para añadir el repositorio de Angie:
   ```console
   $ sudo apt-get update
   $ sudo apt-get install -y ca-certificates curl
   ```
2. Descargue la clave pública del repositorio de Angie
   para la verificación de paquetes:
   ```console
   $ sudo curl -o /etc/apt/trusted.gpg.d/angie-signing.gpg \
               https://angie.software/keys/angie-signing.gpg
   ```
3. Añada el repositorio de 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. Actualice los índices del repositorio:
   ```console
   $ sudo apt-get update
   ```
5. Instale el paquete de Angie:
   ```console
   $ sudo apt-get install -y angie
   ```
6. (*Opcional*) Instale cualquier paquete [extra](#install-extras-oss)
   que necesite:
   ```console
   $ sudo apt-get install -y <NOMBRE DEL PAQUETE>
   ```

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

### FreeBSD

1. Para añadir el repositorio de Angie, cree los directorios:
   ```console
   $ sudo mkdir -p /usr/local/etc/pkg/angie/ /usr/local/etc/pkg/repos/
   ```
2. Para configurar el repositorio, cree un archivo llamado
   `/usr/local/etc/pkg/repos/angie.conf`
   con el siguiente contenido:
   ```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. Descargue la clave pública del repositorio de Angie
   para la verificación de paquetes:
   ```console
   $ sudo curl -o /usr/local/etc/pkg/angie/angie-signing.rsa \
               https://angie.software/keys/angie-signing.rsa
   ```
4. Actualice los índices del repositorio:
   ```console
   $ sudo pkg update
   ```
5. Instale el paquete de Angie:
   ```console
   $ sudo pkg install -r angie -y angie
   ```
6. (*Opcional*) Instale cualquier paquete [extra](#install-extras-oss)
   que necesite:
   ```console
   $ sudo pkg install -r angie -y <NOMBRE DEL PAQUETE>
   ```
7. Inicie el servicio:
   ```console
   $ sudo service angie start
   ```
8. Para iniciar automáticamente Angie después de reiniciar el servidor:
   ```console
   $ sudo sysrc angie_enable=YES
   ```

#### NOTE
Dado que el gestor de paquetes de FreeBSD puede determinar incorrectamente la última versión,
utilice el siguiente enfoque para actualizar los paquetes ya 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 añadir el repositorio, cree un archivo llamado
   `/etc/zypp/repos.d/angie.repo`
   con el siguiente contenido:
   ```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. Actualice los índices del repositorio:
   ```console
   $ sudo zypper refresh
   ```
3. Instale el paquete de Angie:
   ```console
   $ sudo zypper install -y angie
   ```
4. (*Opcional*) Instale cualquier paquete [extra](#install-extras-oss)
   que necesite:
   ```console
   $ sudo zypper install -y <NOMBRE DEL PAQUETE>
   ```
5. Inicie el servicio:
   ```console
   $ sudo systemctl start angie
   ```
6. Para iniciar automáticamente Angie después de reiniciar el servidor:
   ```console
   $ sudo systemctl enable angie
   ```

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

## Extras

Además de los paquetes que proporcionan la funcionalidad básica,
también publicamos algunos paquetes adicionales,
tanto propios como compilados a partir de fuentes de terceros seleccionadas.

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

### Panel web Console Light

Console Light es un panel web ligero de monitorización para Angie,
publicado como `angie-console-light` en nuestros repositorios.
Se instala de la misma manera que el paquete `angie` en los pasos anteriores;
consulte los pasos de configuración en [Panel de monitorización web Console Light](https://es.angie.software//angie/docs/configuration/monitoring.md#monitoring).

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

### Módulos Dinámicos

Para ampliar la funcionalidad básica de Angie,
puede añadir varios módulos dinámicos.
Los módulos pueden [compilarse desde el código fuente](https://es.angie.software//angie/docs/installation/sourcebuild.md#sourcebuild)
para una versión correspondiente de Angie,
pero es más fácil obtenerlos como paquetes ya preparados desde nuestro repositorio:

| [angie-module-image-filter](https://es.angie.software//angie/docs/configuration/modules/http/http_image_filter.md#http-image-filter)                                                                                                     | Añade transformaciones para imágenes JPEG, GIF, PNG y WebP.                                                                                   |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------|
| angie-module-njs:<br/>[JS](https://es.angie.software//angie/docs/installation/external-modules/http_js.md#http-js) (HTTP),<br/>[JS](https://es.angie.software//angie/docs/installation/external-modules/stream_js.md#stream-js) (stream) | Permite usar njs (un subconjunto de JavaScript) en la configuración de Angie<br/>en los contextos `http` y `stream`, respectivamente.         |
| [angie-module-perl](https://es.angie.software//angie/docs/configuration/modules/http/http_perl.md#http-perl)                                                                                                                             | Permite escribir manejadores de `location` y variables en Perl,<br/>y también invocar Perl desde SSI.                                         |
| [angie-module-wamr](https://es.angie.software//angie/docs/configuration/modules/wasm/wasm_wamr.md#wasm-wamr)                                                                                                                             | Permite la integración con [WebAssembly Micro Runtime](https://github.com/bytecodealliance/wasm-micro-runtime)<br/>para ejecutar código WASM. |
| [angie-module-wasm](https://es.angie.software//angie/docs/configuration/modules/wasm/index.md#wasm-core)                                                                                                                                 | Añade soporte principal para WASM.                                                                                                            |
| [angie-module-wasmtime](https://es.angie.software//angie/docs/configuration/modules/wasm/wasm_wasmtime.md#wasm-wasmtime)                                                                                                                 | Permite la integración con el runtime [Wasmtime](https://wasmtime.dev/)<br/>para ejecutar código WASM.                                        |
| [angie-module-xslt](https://es.angie.software//angie/docs/configuration/modules/http/http_xslt.md#http-xslt)                                                                                                                             | Añade un filtro para transformar respuestas XML con hojas de estilo XSLT.                                                                     |

Para usar un módulo instalado en una [configuración](https://es.angie.software//angie/docs/configuration/configfile.md#configfile),
cárguelo usando la directiva [load_module](https://es.angie.software//angie/docs/configuration/modules/core.md#load-module) en el contexto `main`:

```nginx
load_module modules/<nombre del módulo>.so;
```

También está disponible una amplia gama de [módulos de terceros](https://es.angie.software//angie/docs/installation/external-modules/index.md#install-thirdpartymodules).