Como instalar Pangolín en Debian

Requisitos Previos

Un servidor limpio con Debian (11 o 12).
Permisos de administrador (sudo o usuario root).
Puertos abiertos necesarios en tu firewall (habitualmente HTTP/HTTPS u otros puertos personalizados que configure Pangolin).

Guía de Instalación Paso a Paso

Actualizar el Sistema

Paso 1

1.Actualizar el Sistema:Paso 1.

Asegúrate de que los paquetes de tu sistema operativo estén totalmente actualizados ejecutando:

Bash

sudo apt update && sudo apt upgrade -y

Verificación: El comando debe finalizar sin errores de repositorios y con el sistema al día.

Instalar Dependencias Esenciales

Paso 2

2.Instalar Dependencias Esenciales:Paso 2.

Instala herramientas básicas necesarias para descargar y gestionar paquetes, como curl, git y utilidades de red:

Bash

sudo apt install -y curl wget git apt-transport-https ca-certificates gnupg lsb-release

Verificación: Comprueba que curl responde correctamente ejecutando curl --version.

Instalar Docker y Docker Compose

Paso 3

3.Instalar Docker y Docker Compose:Paso 3.

Pangolin se despliega habitualmente de forma contenerizada. Añade el repositorio oficial de Docker e instálalo:

Bash

# Añadir clave GPG y repositorio oficial de Docker
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# Instalar Docker Engine y Docker Compose
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

Verificación: Ejecuta sudo docker compose version para confirmar que se instaló la versión correcta del plugin.

Clonar o Descargar Pangolin

Paso 4

4.Clonar o Descargar Pangolin:Paso 4.

Clona el repositorio oficial de Pangolin o descarga los ficheros de configuración necesarios para su despliegue en tu directorio de trabajo (por ejemplo, en /opt/pangolin):

Bash

sudo mkdir -p /opt/pangolin
cd /opt/pangolin
# Clonar el repositorio correspondiente o descargar la estructura docker-compose
git clone https://github.com/fosrl/pangolin.git .

Verificación: Lista el contenido de la carpeta con ls -la para asegurarte de que están presentes los archivos de configuración y el docker-compose.yml.

Configurar las Variables de Entorno

Paso 5

5.Configurar las Variables de Entorno:Paso 5.

Copia el archivo de ejemplo de entorno y edítalo con tus parámetros personalizados (como dominios públicos, credenciales de base de datos y puertos):

Bash

cp .env.example .env
nano .env

Ajustes clave a revisar en el .env:

APP_URL: Tu dominio público configurado.
Puertos de escucha y claves secretas o tokens de conexión. Verificación: Guarda los cambios en el archivo (Ctrl+O, Enter, Ctrl+X en Nano) y asegúrate de que no queden campos obligatorios vacíos.

Iniciar el Despliegue con Docker Compose

Paso 6

6.Iniciar el Despliegue con Docker Compose:Paso 6.

Despliega los contenedores de Pangolin en segundo plano utilizando Docker Compose:

Bash

sudo docker compose up -d

Verificación: Ejecuta sudo docker compose ps para comprobar que todos los servicios relacionados con Pangolin se encuentran en estado Up (en ejecución).