Evolution API Installation Guide

This guide outlines the necessary steps to install MongoDB, Redis, Nginx, and the Evolution API. Follow these steps sequentially to set up your environment properly.

Prerequisites

Ensure your system is up to date.
Ubuntu 22.0 or above
Must login with user root
Make sure wget is installed before proceeding with the installations.

Installation Steps

1. Install MongoDB

1.1 Download and run the MongoDB installation script

wget https://raw.githubusercontent.com/drhema/evolution-api-installation/main/1-mongo_install.sh && chmod +x 1-mongo_install.sh && ./1-mongo_install.sh

mongosh "mongodb://localhost:27017"

use api_db
db.createUser({
  user: "api_user",
  pwd: "ApiPassw0rd!2024",  // Use the intended password
  roles: [{role: "readWrite", db: "api_db"}]
})

Exit

mongosh 'mongodb://api_user:ApiPassw0rd!2024@localhost:27017/api_db'

1.2 Check the status of MongoDB

Ensure MongoDB is running:

sudo systemctl status mongod

If MongoDB is not running, start it:

sudo systemctl start mongod

Verify MongoDB is listening on port 27017:

sudo ss -tulwn | grep 27017

2. Install Redis

Download and execute the Redis installation script:

wget https://raw.githubusercontent.com/drhema/evolution-api-installation/main/2-redis.sh && chmod +x 2-redis.sh && ./2-redis.sh

3. Check Redis Connection

Ensure that Redis is installed and operating correctly:

wget https://raw.githubusercontent.com/drhema/evolution-api-installation/main/3-redis_check.sh && chmod +x 3-redis_check.sh && ./3-redis_check.sh

4. Install Nginx

Install Nginx and configure SSL with Let's Encrypt: insert your subdomain ex: api.yourdomain.com & your email address email@yourdomain.com

wget https://raw.githubusercontent.com/drhema/evolution-api-installation/main/4-nginx.sh && chmod +x 4-nginx.sh && ./4-nginx.sh

5. Install Evolution API

Set up the Evolution API along with its dependencies:

wget https://raw.githubusercontent.com/drhema/evolution-api-installation/main/5-EvolutionAPI.sh && chmod +x 5-EvolutionAPI.sh && ./5-EvolutionAPI.sh

Navigate to the evolution-api directory and restart Nginx:

cd evolution-api
sudo systemctl restart nginx

To start the Evolution API in production mode:

screen

npm run start:prod

Detach from the screen session by pressing Ctrl+A followed by D.

access the API via https://sub.domain.com/manager insert your password or if u used the default

B6D711FCDE4D4FD5936544120E713976

Edit https and port 443:

nano src/env.yml

Edit http ===> https
Port 8080 ===> 443

sudo lsof -i :8080
sudo lsof -i :443
sudo kill -9 17496

sudo nginx -t

for any support contact: me@ibrahim.agency

aammo1 / evolution-api-installation