Minimum cloud configuration:
  • RAM: 4 GB (8 GB recommended)
  • CPU: 2 vCPUs (4+ vCPUs recommended)
  • Storage: 50 GB SSD minimum (100 GB recommended)
  • OS: Ubuntu 22.04 LTS
  • Network: Public IP with ports 22, 80, 443 open
Cloud Providers Supported
  • AWS EC2 (t3.medium or better)
  • DigitalOcean Droplets (Basic plan or better)
  • Other providers with Ubuntu 22.04 support (For localhost, please check local-setup)
Based on our testing, these configurations provide optimal performance for WeamAI workloads.⚠️ Using lower specs may lead to build failures or performance issues.Domain Requirements:
  • Development: No domain needed (uses IP address)
  • Production: Custom domain required for HTTPS/SSL

​
Deployment Options

1

Launch EC2 Instance

Navigate to AWS Console and configure your instance:Instance Configuration:
  • AMI: Ubuntu Server 22.04 LTS
  • Instance Type: t3.medium or better
  • Storage: 50 GB GP2/GP3 SSD minimum
  • Security Group: Allow SSH (22), HTTP (80), HTTPS (443)
For testing, you can allow all inbound traffic, but configure proper security groups for production.
2

Configure Key Pair

Create or select an existing key pair for SSH access. Download the .pem file and keep it secure.
3

Add User Data Script

In Advanced Details → User Data, paste the appropriate script:
#!/bin/bash
exec > /home/ubuntu/setup.log 2>&1
set -xe

# Update system and install dependencies
sudo apt update -y
sudo apt install -y git curl

# Detect public IP
PUBLIC_IP=$(curl -s http://checkip.amazonaws.com || curl -s ifconfig.me || hostname -I | awk '{print $1}')
echo "Detected Public IP: $PUBLIC_IP"

# Clone and setup project
sudo git clone https://github.com/weam-ai/weam.git /home/ubuntu/project
cd /home/ubuntu/project
sudo cp .env.example .env

# Configure for development
sed -i.bak 's|NEXT_PUBLIC_APP_ENVIRONMENT=production|NEXT_PUBLIC_APP_ENVIRONMENT=development|' .env
sudo sed -i "s/localhost/$PUBLIC_IP/g" .env

# Install Docker and Docker Compose
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

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

sudo apt update -y
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

sudo systemctl enable docker
sudo systemctl start docker
sudo chmod 666 /var/run/docker.sock

echo "✅ Development setup completed successfully!"
4

Launch Instance

Review your configuration and click Launch Instance. Wait 5-10 minutes for the initialization script to complete.
5

Connect and Deploy

Connect to your instance via SSH:
ssh -i your-key.pem ubuntu@<EC2_PUBLIC_IP>
Navigate to the project directory and start the build:
# Check setup completion
tail -f /home/ubuntu/setup.log

# Navigate to project directory
cd /home/ubuntu/project

# Build the application (15-20 minutes)
bash build.sh

# Deploy with Docker Compose
docker compose up --build

# For background deployment
docker compose up -d
6

Access Application

Development Setup:
http://<EC2_PUBLIC_IP>:3000/login
Production Setup:
https://your-domain.com/login
For production, ensure your domain’s DNS A record points to your EC2 instance’s public IP address.

​
SSL Certificate Setup (Production Only)

After your application is running and DNS is properly configured, enable free SSL certificates: 
# Replace with your actual domain
sudo certbot --nginx -d your-domain.com

# Follow the interactive prompts to complete SSL setup

​
Service Architecture

ServicePortInternal URLDescription
Frontend (Next.js)3000http://localhost:3000Main web interface
Backend (Node.js)4050http://localhost:4050API server
Python API9089http://localhost:9089AI/ML processing
MongoDB27017Internal onlyDatabase
Redis6379Internal onlyCache/sessions
Qdrant6333http://localhost:6333Vector database
MinIO9000http://localhost:9000Object storage

​
Troubleshooting

Important Notes:
  • WeamAI requires HTTPS for production login
  • You must use a custom domain with SSL certificate for production
  • Development mode allows HTTP access via IP address
  • Build process takes 15-20 minutes on first deployment
  • Ensure adequate system resources to avoid build failures