# JournalDock Linux Connector

This package runs the JournalDock MT5 connector on Linux Desktop or an Ubuntu VPS with a desktop environment.

It is designed for MT5 running through Wine. The connector reads the JournalDock MT5 EA export files and sends them to the JournalDock website API.

## What Users Need

- Ubuntu Desktop or Ubuntu VPS with a desktop session
- MT5 installed through Wine
- JournalDock MT5 EA attached to an MT5 chart
- A JournalDock connector token from MT5 Pilot, or one sent by admin

## Install

From the repo or extracted package:

```bash
cd connector/linux
chmod +x install-linux-connector.sh
./install-linux-connector.sh
```

## Configure

```bash
journaldock-linux-connector configure
```

The setup asks for:

- JournalDock API URL
- Connector token
- MT5 EA export folder

The common Wine export folder is usually:

```text
~/.mt5/drive_c/users/$USER/AppData/Roaming/MetaQuotes/Terminal/Common/Files/tradebook_bridge
```

If MT5 was installed with a normal Wine prefix, try:

```text
~/.wine/drive_c/users/$USER/AppData/Roaming/MetaQuotes/Terminal/Common/Files/tradebook_bridge
```

## Move The JournalDock EA Into MT5 On Linux/Wine

If the JournalDock EA was downloaded into the Linux Downloads folder, first find the exact MT5 Expert Advisors folder:

```bash
find ~ -type d -path "*MQL5/Experts" 2>/dev/null
```

Then copy the EA into the Experts folder. For a normal Wine install, this is usually:

```bash
cp ~/Downloads/TradeBookBridgeEA.ex5 ~/.wine/drive_c/Program\ Files/MetaTrader\ 5/MQL5/Experts/
```

If your find command shows a different Experts folder, copy into that exact folder instead. Example:

```bash
cp ~/Downloads/TradeBookBridgeEA.ex5 "/path/from/find/command/MQL5/Experts/"
```

If the EA file name is slightly different, check the Downloads folder with:

```bash
ls ~/Downloads
```

After copying the EA:

1. Open MT5
2. Go to Navigator
3. Right-click Expert Advisors
4. Click Refresh
5. Attach the JournalDock EA to a chart

## Start and Stop

```bash
journaldock-linux-connector start
journaldock-linux-connector stop
journaldock-linux-connector status
```

Logs are stored at:

```text
~/.journaldock-connector/connector.log
```

Config is stored at:

```text
~/.journaldock-connector/connector-config.json
```

## Optional Auto Start

```bash
systemctl --user enable journaldock-connector.service
systemctl --user start journaldock-connector.service
```

To stop auto-start:

```bash
systemctl --user disable journaldock-connector.service
systemctl --user stop journaldock-connector.service
```

## Important

Keep MT5 open, logged in, and running with the JournalDock MT5 EA attached to a chart. The Linux connector cannot read trades if the EA is not exporting `account_state.json` and `trade_state.json`.