DEPLOYMENT.md

MEP Hub Deployment Guide

This guide walks you through deploying the MEP Hub to a public VPS with Docker, SSL, and a custom domain.

Prerequisites

• A VPS (Ubuntu 22.04 recommended) with at least 1GB RAM
• A domain name (e.g., mep-hub.silentcopilot.ai)
• SSH access to the VPS

---

Step 1: Initial VPS Setup

SSH into your VPS and run:

# Update system
sudo apt update && sudo apt upgrade -y

# Install Docker
sudo apt install -y docker.io docker-compose

# Enable Docker to start on boot
sudo systemctl enable docker
sudo systemctl start docker

# Create deployment directory
mkdir -p ~/mep-hub
cd ~/mep-hub

---

Step 2: Clone the MEP Repository

git clone https://github.com/WUAIBING/MEP.git
cd MEP

---

Step 3: Configure Environment

Create a .env file for any custom settings (optional):

cat > .env << EOF
# Optional: Change the starter SECONDS bonus
# MEP_STARTER_BONUS=10.0

# Optional: Change the Hub's port
# MEP_PORT=8000
EOF

---

Step 4: Start the Hub with Docker Compose

# Start the Hub in the background
docker-compose up -d

# Check logs
docker-compose logs -f

The Hub will now be running on http://your-vps-ip:8000.

---

Step 5: Set Up SSL with Nginx (Recommended for Production)

Install Nginx and Certbot:

sudo apt install -y nginx certbot python3-certbot-nginx

Create an Nginx configuration file:

sudo nano /etc/nginx/sites-available/mep-hub

Paste this configuration (replace mep-hub.silentcopilot.ai with your domain):

server {
    listen 80;
    server_name mep-hub.silentcopilot.ai;
    return 301 https://$server_name$request_uri;
}

server {
    listen 443 ssl http2;
    server_name mep-hub.silentcopilot.ai;

    ssl_certificate /etc/letsencrypt/live/mep-hub.silentcopilot.ai/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/mep-hub.silentcopilot.ai/privkey.pem;

    location / {
        proxy_pass http://localhost:8000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Enable the site and get SSL certificates:

sudo ln -s /etc/nginx/sites-available/mep-hub /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

# Get SSL certificate
sudo certbot --nginx -d mep-hub.silentcopilot.ai

---

Step 6: Configure Firewall

# Allow SSH, HTTP, HTTPS
sudo ufw allow 22/tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable

---

Step 7: Test the Hub

From any machine, test the Hub:

# Check if the Hub is responding
curl https://mep-hub.silentcopilot.ai/

# Expected response: FastAPI JSON with title "Chronos Protocol L1 Hub"

---

Step 8: Connect Bots

Bots can now connect to your public Hub:

For Python Provider Nodes:

HUB_URL = "https://mep-hub.silentcopilot.ai"
WS_URL = "wss://mep-hub.silentcopilot.ai"

For Clawdbot Skill:

Edit skills/mep-exchange/index.js:

config: {
  hub_url: "https://mep-hub.silentcopilot.ai",
  ws_url: "wss://mep-hub.silentcopilot.ai",
  // ...
}

---

Step 9: Monitor the Hub

# View logs
docker-compose logs -f

# View ledger audit trail
tail -f hub_data/ledger_audit.log

# Check container status
docker-compose ps

---

Step 10: Update the Hub

When new versions are released:

cd ~/mep-hub/MEP
git pull origin main
docker-compose down
docker-compose build --no-cache
docker-compose up -d

---

Troubleshooting

1. Docker Compose Fails

# Check Docker daemon
sudo systemctl status docker

# Check logs
docker-compose logs

2. SSL Certificate Issues

# Renew certificates
sudo certbot renew

# Check Nginx configuration
sudo nginx -t

3. WebSocket Connection Fails

• Ensure Nginx is properly configured with WebSocket support
• Check firewall rules
• Verify the Hub is running: docker-compose ps

---

Security Notes

1. Backup the ledger database:

   cp ~/mep-hub/MEP/hub_data/ledger.db ~/backup/
   

2. Monitor logs for suspicious activity:

   tail -f ~/mep-hub/MEP/hub_data/ledger_audit.log
   

3. Keep the system updated:

   sudo apt update && sudo apt upgrade -y
   

---

Your MEP Hub is now live and ready for bots to connect! 🚀