End User Public Specification
OS Template for
MetaTrader 4 / 5 #
Specification Document #
This is a public specification document for stable operation of MetaTrader 4 / 5 with Wine on Ubuntu 24.04 LTS (Kubuntu Desktop).
We have clearly summarized “what is included,” “how to use it,” and “which template is right for you,” including the differences between products.
Document Information #
This update #
- Console FXVPS has no XRDP
- Remote Desktop FXVPS / OptiMax include XRDP
- Clarified template differentiation
Template Lineup
Template Types and Connection Methods #
First, confirm whether your template includes XRDP or not.
Connection methods and intended use cases vary by template type.
No XRDP
Console FXVPS #
For beginners / lightweight configuration / operations without unnecessary resident services
- Connection method:Console
- XRDP:Not included
- Best for:Simple MT usage
- Note:Not designed for remote desktop connection
XRDP Included
Remote Desktop FXVPS #
For intermediate to advanced users / configured for regular remote desktop connection use
- Connection method:XRDP / Console
- XRDP:Standard included
- Best for:Users who want desktop control from external PCs
- Protection:Connection is temporarily restricted if multiple login failures occur in a short time
XRDP Included
OptiMax #
For high-performance operations / remote desktop required / higher-tier system optimized for MT
- Connection method:XRDP / Console
- XRDP:Standard included
- Best for:Heavy load, multiple instances, premium plan operations
- Protection:Connection is temporarily restricted if multiple login failures occur in a short time
Value
OS Template Key Specifications #
We have preset the fragile parts of MetaTrader operation in advance
so that users can simply double-click the MT4 / MT5 .exe from the GUI and start using it.
Wine Fixed #
WineHQ devel 10.2 is pinned to prevent unintended updates or variants.
Japanese Display Improved #
Without Windows fonts, we apply settings that reduce tofu (□) and garbled characters.
Double-Click Launch #
When you open a .exe, wine-mt launches and automatically selects the prefix for MT4 / MT5.
MT5 Multi-Launch Support #
Prefix pool (4 slots by default) distributes load and reduces conflicts during simultaneous startup.
Recovery Tools Included #
MetaTrader Reset (Wine) is available from the menu for when things get slow or freeze.
Diagnostic Tools Included #
MetaTrader Diagnostics (wine-mt) is provided for support purposes.
Prerequisites
Usage Requirements #
Important: Run Wine GUI operations on X11 session #
GUI operations involving Wine, such as installers, login screens, and configuration screens, must be executed on a GUI session.
- OK:Proxmox Console / VNC / XRDP (for templates that include it)
- NG:Launching GUI only via SSH, forcing use on Wayland
Included
What’s Included in the Template #
Wine Fixed #
Wine is WineHQ devel 10.2. With pinning + hold, we ensure the version does not inadvertently change or branch.
Automatic Updates Disabled #
To prevent MT instability from unexpected updates, unattended-upgrades / apt-daily are disabled.
Japanese Font Handling #
Using Noto / IPA fonts on the Linux side and substitution settings on the Wine side, this creates a configuration that reduces tofu and garbled characters.
wine-mt Handler #
wine-mt manages .exe startup and automatically selects the appropriate prefix for MT4 / MT5.
Additional Items for XRDP-Enabled Templates #
Remote Desktop FXVPS and OptiMax come with XRDP standard.
If multiple login failures are detected from the same source IP within a certain time, the IP will be temporarily banned.
- Be careful not to mistype your password multiple times.
- If you believe you were accidentally blocked, wait a while or open a support ticket.
Usage
User-Facing Mechanisms #
Bring-Your-Own MT4/5 .exe Double-Click Operation #
- Double-clicking a
.exein the file manager launches wine-mt. - MT4 / MT5 executables and installers automatically select the appropriate prefix.
- For safety, by default non-MT
.exefiles are blocked from launching.
Prefix Layout #
- MT4:
~/.mt4 - MT5:
~/.mt5pool/mt5-01～~/.mt5pool/mt5-0N
Recommended Workflow #
- Use the GUI connection appropriate for your template
- Prepare MT4 / MT5 installer
.exeor bring the entire MetaTrader folder from your environment. - Double-click the
.exeto launch it - After installation, launch
terminal.exeorterminal64.exe
Pool
MT5 Multi-Launch Concept #
When MT5 simultaneous launches increase, prefix conflicts can make it unstable.
This template is designed with the premise of distributing across multiple prefixes.
~/.mt5pool/mt5-01~/.mt5pool/mt5-02~/.mt5pool/mt5-03~/.mt5pool/mt5-04Tips for Stable Operation #
wine-mt determines allocation based on the .exe location.
Separating folder names makes prefix distribution easier and simultaneous launching more stable.
MT5-A/terminal64.exe
MT5-B/terminal64.exe
MT5-C/terminal64.exe
MT5-D/terminal64.exeSupport Tools
Reset and Diagnostics #
MetaTrader Reset (Wine) #
A tool to reset only the Wine state when things are slow, frozen, or unresponsive.
- Terminates running MT
- Can be used as an alternative to OS restart
- Available from the application menu
MetaTrader Diagnostics (wine-mt) #
Easily collects environment information and status for support and troubleshooting.
- Available from the application menu
- CLI execution instructions may be provided as needed
- Share results with support
Limitations
Known Limitations and Notes #
Automatic updates are disabled
OS security and package updates are performed according to management scheduling.
Wine is fixed
Users must not update Wine on their own or mix different Wine versions, as this may cause issues.
.exe launching is primarily limited to MT
For safety, by default non-MT .exe files are blocked from launching. Contact support if exceptions are needed.
XRDP availability depends on template
Console FXVPS has no XRDP; Remote Desktop FXVPS and OptiMax include XRDP.
MT behavior can change due to external factors
Behavior may vary depending on broker, EA, WebView2, network conditions, and other factors.
Troubleshooting
Troubleshooting #
Confirming connection method and session type first can speed up root cause analysis.
nodrv_CreateWindow appears #
You are likely running outside a GUI session. Reconnect via Console or XRDP.
MT becomes slow when launched multiple times #
First check that you’re not launching too many instances, then run MetaTrader Reset (Wine) if it doesn’t improve.
Cannot connect via XRDP suddenly #
You may be temporarily restricted due to repeated password failures. Wait a while or open a support ticket.
Reset / Diagnostics doesn’t appear in menu #
kbuildsycoca6 2>/dev/null || true
kbuildsycoca5 2>/dev/null || trueIf it still doesn’t appear, try logging out and logging back in.
Helpful information for support #
- Date and time (JST)
- What you launched (MT4/MT5, which folder)
- Diagnostics results
- Values of
DISPLAYandXDG_SESSION_TYPE - If using XRDP, whether it was after a login failure
