WSL and VPS Deployment Guide

Name: MQL5 Algo Forge
Brand: MQL5

This guide covers the setup and deployment of the MQL5 Trading Automation system, specifically for users running on Windows with WSL (Ubuntu) and deploying to a VPS.

1. Local Setup (Windows & WSL)

Windows Side ("Window")

For the MetaTrader 5 terminal and general orchestration on Windows:

Reset Environment (If you need a fresh start): Run the reset script in PowerShell to clean logs and temporary files.

Optional: Clean specific MT5 Terminal Logs If your MT5 Logs folder is cluttered (e.g., contains .git or random files), pass the path to your Data Folder:
```
.\scripts\reset_environment.ps1 -MT5DataPath "C:\Users\USER\AppData\Roaming\MetaQuotes\Terminal\YOUR_ID"
```
Standard Reset:
```
.\scripts\reset_environment.ps1
```
Startup: To start the automation (MT5 Terminal + Python Orchestrator):
```
.\scripts\startup.ps1
```

WSL Side ("Ubuntu WSL")

If you are using WSL (Windows Subsystem for Linux) to manage the code or run Linux-specific tools:

Install Prerequisites: Open your Ubuntu terminal (WSL) and run:
```
sudo ./scripts/setup_ubuntu.sh
```
This installs Python, Node.js, and other dependencies within the WSL environment.
Validate Repository:
```
python3 scripts/ci_validate_repo.py
```

2. Deploy to VPS

To deploy your changes to a VPS (Virtual Private Server), typically running Ubuntu:

Option A: Using Docker Hub (Recommended)

This method builds the image locally (or in CI) and pushes it to Docker Hub, then pulls it on the VPS.

Build and Push:

./scripts/deploy_docker_hub.sh [YOUR_DOCKER_USERNAME] [YOUR_TOKEN]

Update VPS: SSH into your VPS and run:
```
./scripts/update_vps.sh
```

Option B: Manual File Transfer (SCP/Git)

If you don't use Docker Hub:

SSH into VPS:
```
ssh user@your-vps-ip
```
Pull Changes (if using Git on VPS):
```
cd /path/to/repo
git pull
```
Run Setup/Update:
```
sudo ./scripts/setup_ubuntu.sh
```

3. Magic Number Update

The Magic Number for the Expert Advisors has been updated to 81001. Ensure your running EA instances on the VPS or local terminal are restarted to pick up this change.

EXNESS_GenX_Trader.mq5: Default Expert_MagicNumber = 81001
SMC_TrendBreakout_MTF_EA.mq5: Default MagicNumber = 81001

2.5 KiB Raw Permalink Blame History