> For the complete documentation index, see [llms.txt](https://mt5-m0rpheu5.gitbook.io/mt5.m0rpheu5-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mt5-m0rpheu5.gitbook.io/mt5.m0rpheu5-docs/support/troubleshooting.md). # Troubleshooting *** ## Connection Issues ### MT5 Not Connected **Symptoms:** Red X next to "MT5 Connected" in the status bar. **Solutions:** 1. Make sure MetaTrader 5 is **open** and logged into your trading account 2. Close MT5, start MT5 Link, then open MT5 (order matters) 3. Check that MT5 path points to the correct terminal.exe: * Open Settings → Browse to `terminal.exe` * Common path: `C:\Program Files\MetaTrader 5\terminal.exe` 4. Run MT5 as Administrator ### Telegram Bot Not Active **Symptoms:** Red X next to "Bot Active" in the status bar. **Solutions:** 1. Check API credentials are correct (Settings → Telegram) 2. Make sure your phone number includes country code (e.g. `+1` for US/Canada) 3. Delete the session file and re-authenticate: * Close MT5 Link * Restart MT5 Link (it will prompt to re-authenticate) ### Signal Watcher Not Active **Symptoms:** Gray or yellow status pill for Signal **Solutions:** 1. Check credentials for your signal source * **Telegram**: all 4 fields filled, channel ID correct * **Discord**: bot token and channel ID valid 2. Make sure you're a member of the signal channel 3. Click **Test Connection** (Discord) or verify channel ID format (Telegram) 4. Check the log for specific error messages *** ## Signal Issues ### Signals Not Being Executed **Symptoms:** Signals appear in Telegram but no orders are placed in MT5. **Check the log for:** * **"Skipped — price too far"** → Signal is stale, entry price is too far from market * **"Symbol not found"** → Add symbol mapping (Settings → Symbol Mappings) * **"Lot size too small"** → Adjust min lot size in Settings → Risk * **"No balance"** → Check your MT5 account balance ### Wrong Symbol Traded **Symptoms:** Order placed on XAUUSD instead of GOLD (or similar). **Solution:** Add a symbol mapping: 1. Go to Settings → Symbol Mappings 2. Click **"+ Add"** 3. Enter the signal symbol (e.g. `GOLD`) and your broker's symbol (e.g. `XAUUSD`) 4. Click **"Scan MT5"** to auto-fill 5. Click **Save** ### Orders Not Closing on TP/SL **Symptoms:** Position doesn't close when price hits TP or SL. **Solutions:** 1. TP/SL are set by MT5 Link — make sure they're configured in Settings → Risk 2. Check that your broker allows TP/SL on pending orders 3. Some brokers require manual TP/SL setting — check broker settings *** ## Update Issues ### Update Fails to Download **Symptoms:** "Update available" banner but download doesn't start. **Solutions:** 1. Check internet connection 2. Temporarily disable antivirus/firewall 3. Download manually from the Product Page ### Update Fails to Install **Symptoms:** Download completes but app doesn't restart. **Solution:** 1. Close MT5 Link completely (check Task Manager for `mt5-link-client.exe`) 2. Run the installer manually from your Downloads folder ### "Access Denied" During Update **Symptoms:** Error about not being able to replace files. **Solution:** 1. Close MetaTrader 5 completely 2. Close MT5 Link 3. Run MT5 Link as Administrator 4. Try updating again *** ## Crash / Freeze Issues ### App Crashes on Startup **Solutions:** 1. Reset config and restart: * Close MT5 Link * Restart MT5 Link (Setup Wizard will appear) 2. Reinstall: * Uninstall MT5 Link * Reinstall from Product Page ### App Freezes During Trading **Solutions:** 1. Check if MT5 is responding (try clicking in MT5 window) 2. Check internet connection 3. Look at the log for error messages 4. Restart both MT5 and MT5 Link *** ## Signal Issues ### "No Stop Loss — refusing trade" * MT5 Link requires a Stop Loss on every BUY/SELL signal * Add `Stop Loss:` to your signal or ask your provider to include it * Cancel/close signals don't need SL ### Discord Connection Fails 1. Verify the bot token is correct 2. Ensure the channel ID is the numeric ID (right-click → Copy ID) 3. Make sure the bot has been invited to the channel 4. Check the diagnostics log for details *** ## Notification Issues ### Not Receiving Notifications 1. Check **Settings → Notifications** — all toggles on 2. Make sure you **started a chat with the bot** (send `/start` to @your\_bot) 3. Check your Telegram **notification settings** for the bot chat 4. Verify the bot is **not blocked** ### Too Many Notifications * Turn off "Signal Received" if your provider sends many signals * Turn off "Trailing Stop Updated" (most verbose) *** ## Still Need Help? Email: **** Include: * Screenshot of the error * What you were doing when it happened * Last 20 lines from the log (Settings → View Log) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://mt5-m0rpheu5.gitbook.io/mt5.m0rpheu5-docs/support/troubleshooting.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.