Troubleshooting & FAQ
Connection status
The connection pill in the header shows the most important state first:
| Pill | Dot | Meaning |
|---|---|---|
| OFFLINE | Red | Your computer has no network connection. |
| CONNECTING | Amber, pulsing | Logging in to Rithmic, or reconnecting. |
| Market Replay | Green | A replay session is running. See Market Replay. |
| Connection name | Green | Connected. +N means N more connections are active. |
When nothing is connected, the account selector reads Disconnected. In the Connection Manager, each connection shows Connected, Connecting… or Disconnected, and the Replay row shows Replaying, Connecting… or Idle. Errors appear under the row as “Connection error: …”.
Automatic reconnects
| Situation | What TickMint does |
|---|---|
| A Rithmic connection drops | Reconnects automatically, waiting 1 s and backing off to 30 s between tries. |
| The UI loses the local gateway | Reconnects automatically, backing off from 1 s to 30 s. |
| The gateway process crashes (desktop) | Restarts it after 1, 2, 5, 10, then 30 s. |
| Rithmic rejects your login | Never retries. Fix the problem, then click Connect. |
| You’re logged out by another session | Doesn’t reconnect. Close the other session, then reconnect. |
Login errors
| Message | Cause | Fix |
|---|---|---|
| Authentication failed: Invalid User ID or Password for … | Wrong username or password for that system. | Re-enter both. Prop firms often issue separate Rithmic credentials from your dashboard login. |
| Authentication failed: No password provided… | No password saved for this connection. | Edit the connection and enter the password. |
| System error: The Rithmic system ”…” was rejected or is currently unavailable. | Wrong system name, or the system is down. | Check the system name your firm gave you (for example Apex or Rithmic Paper Trading). |
| CME market data agreement required: Please log into R|Trader Pro once… | You haven’t accepted the exchange data agreements. | Log in to R|Trader Pro once, accept the agreements, then reconnect. |
| Concurrent session collision: … close R|Trader Pro… | The same login is in use elsewhere. | Close R|Trader Pro or the other platform, then reconnect. |
| Forced logout: Another session logged into this Rithmic account. | Another app logged in with your credentials. | Close the other session, then reconnect. |
| Rithmic Login Rejected (…): … | Rithmic refused the login with a specific code. | Contact your firm or Rithmic with the codes shown. |
| Rithmic connection dropped (Code 1006). Verify system name and network connection. | The socket closed unexpectedly. | Check your network, firewall or VPN, and the system name. |
See Rithmic setup for adding and editing connections.
Order routing
If the order connection drops, TickMint shows “Reconnecting…”. If it stops completely you’ll see that orders will be rejected until you reconnect.
Gateway errors
| Message | Fix |
|---|---|
| TickMint Gateway failed to start (for example “Timed out after 20s…”) | Quit and restart TickMint. If it keeps happening, launch from a terminal to see the gateway output (see Logs). |
| Rithmic Gateway unavailable. Ensure gateway service is running. | The UI can’t reach the local gateway. Restart TickMint. |
Cannot listen on 127.0.0.1:<port> (EADDRINUSE …) |
Another program is using the port. See below. |
Port already in use
The packaged desktop app picks a free port automatically, so this mainly affects running the gateway from source (default port 8080). Find what’s using the port:
lsof -nP -iTCP:8080 -sTCP:LISTENnetstat -ano | findstr :8080tasklist /FI "PID eq <pid>"# Windows can reserve port ranges; check them with:netsh int ipv4 show excludedportrange protocol=tcpStop the other program, or set TM_GATEWAY_PORT (or PORT) to a different port, or to 0 to let the OS choose. The gateway exits with code 78 when it can’t get its port.
Chart and data problems
| What you see | Meaning and fix |
|---|---|
| Offline chip (“Data provider offline. Click to connect broker.”) | No market data connection. Click the chip to open the Connection Manager. |
| No data at all | TickMint gets all market data from Rithmic. There is no built-in data feed, so you need an active Rithmic connection. |
| DELAYED chip | Data is arriving 3 s or more behind the exchange. It turns red at 30 s. Check your network and CPU load, and close unused charts. Not shown in replay. |
| Reduced fidelity (1s bars) | The chart is built from 1-second bars instead of ticks, so tick-based detail is approximate. |
| “Contract Rollover: … Update to …” | The front month has changed. See Rollover. |
| Empty DOM or “No depth in Replay” | Market Replay has no depth data. DOM ladders, depth and heatmap stay empty during replay. |
Windows and pop-ups
| Problem | Fix |
|---|---|
| A pop-out, the copier or the journal doesn’t open | It was blocked as a pop-up. Allow pop-ups for TickMint and try again. |
| ”… chart window(s) … could not be reopened automatically” | Click Restore in the message to reopen them. |
| A window opened off-screen | TickMint saves window positions in the data folder (window-state.json and similar). Quit TickMint and delete the file for that window to reset it. |
See Pop-out windows.
Logs
TickMint doesn’t write log files. The gateway’s output goes to the app’s console, prefixed with [Gateway]. To see it, launch TickMint from a terminal:
/Applications/TickMint.app/Contents/MacOS/TickMint& "$env:LOCALAPPDATA\Programs\TickMint\TickMint.exe"/opt/TickMint/tickmint-desktopPaths assume the default install location. Copy the output when reporting a problem, and remove any account numbers first.
Where is my data?
| OS | Data folder |
|---|---|
| macOS | ~/Library/Application Support/TickMint |
| Windows | %APPDATA%\TickMint |
| Linux | ~/.config/TickMint |
See Local-first & privacy for what each file contains.
FAQ
Does TickMint have its own data feed? No. All market data, orders and history come from your Rithmic connection.
Can I trade without a Rithmic account? You can place simulated orders on SIM-1, but charts still need Rithmic market data. See SIM mode.
Why is the DOM empty in replay? Rithmic replay doesn’t provide depth. Replay is also limited to 4 instruments and the last 90 days.
Are replay trades in my journal? No. REPLAY-1 trades are never journaled. SIM-1 trades are, when SIM is ticked in the journal filters.
Can I import trades from a CSV or another platform? No. The journal only builds trades from Rithmic fills, including history you sync from Rithmic, and SIM-1. You can export to CSV.
Can I run TickMint and R|Trader Pro at the same time? Only with different logins. Using the same Rithmic login in both causes a session collision or forced logout.
Does TickMint send my data anywhere? No telemetry or analytics. See Local-first & privacy for the only outbound connections.
How do I reset TickMint completely?
- Quit TickMint.
- Back up the data folder if you want to keep anything.
- Delete the data folder.
- Start TickMint. It starts fresh, and you’ll need to add your connections again.