Cómo Instalar Evolution API en un VPS con Docker Paso a Paso

Evolution API Dockerizado para VPS Linux

Este proyecto está basado en el repositorio oficial de Evolution API, una solución para enviar mensajes de WhatsApp a través de una API sencilla y potente.

Este entorno incluye:

• Evolution API
• Redis
• PostgreSQL
• Variables de entorno configurables
• Documentación clara para exponer puertos y asegurar el servicio

Ideal para los que deseen tener Evolution API funcionando en un VPS minutos, sin configuraciones complicadas ni instalaciones manuales.

Requisitos

Asegúrate de tener instalados:

docker -v
docker compose version

Si no los tienes, puedes instalarlos con:

• Docker Engine
• Docker Compose Plugin

También se recomienda agregar tu usuario al grupo docker para evitar usar sudo:

• Post-installation steps for Linux

Instalación de Evolution API

1. Clona este repositorio

git clone https://github.com/devalexcode/docker-evolution-api.git

Ingresa a la carpeta del repositorio:

cd docker-evolution-api

2. Crea el archivo .env

cp .env.example .env

Configuración del archivo .env

Antes de levantar los servicios, asegúrate de crear y configurar tu archivo .env:

nano .env

Edita el archivo .env con tus propios valores:

# EVOLUTION API
AUTHENTICATION_API_KEY=tu_clave_api_aqui           # Clave de autenticación para la API de Evolution
EVOLUTION_API_PORT=8080                            # Puerto donde se expondrá la API (si tienes otra aplicación corriendo por este puerto cambia este valor)

# REDIS
REDIS_PORT=6379                                     # Puerto por defecto de Redis

# POSTGRESQL
POSTGRESS_PORT=5432                                 # Puerto por defecto de PostgreSQL
POSTGRESS_USER=usuario_postgres                     # Usuario de la base de datos (POR SEGURIDAD MODIFICA ESTE VALOR)
POSTGRESS_PASS=clave_segura                         # Contraseña del usuario (POR SEGURIDAD MODIFICA ESTE VALOR)

3. Levanta los servicios

docker compose up -d

Verifica que el contenedor esté en ejecución

Después de levantar el entorno con docker compose up -d, puedes verificar que Evolution API se esté ejecutando correctamente con:

docker ps

Deberías ver una salida similar a esta:

CONTAINER ID   IMAGE                            COMMAND                  CREATED          STATUS              PORTS                                                                                   NAMES
e3b6d8e6c317   atendai/evolution-api:latest     "/bin/bash -c '. ./D…"   28 seconds ago   Up 26 seconds       0.0.0.0:8080->8080/tcp, [::]:8080->8080/tcp                                            evolution_api

Acceso a la aplicación

Accede desde el navegador (o usa curl) en:

http://IP_DEL_SERVIDOR:8080/manager