TCMinerProxy

Documentation

TMS installation

Install TMS3 on Linux and Windows, including default access, WebView2, and architecture choices.

TMS Installation

TMS3 is the recommended current client. According to the TMS GitHub guide, TMS3 requires TCMinerProxy server v4.5.0 or later when using the TMS3 protocol, and TMS3 is not compatible with TMS1/TMS2 protocol ports.

Reference source: https://github.com/MinerProxyPro/TMS

Before Installation

  • Choose a device that will stay online in the mining-site LAN.
  • Give this device a fixed LAN IP address. If DHCP changes the IP after a reboot, miners may lose the TMS address.
  • Prepare root access for Linux installation.
  • Open the TMS web port in your LAN firewall if needed. The default web access is http://DEVICE_IP:42703.
  • Prepare the TCMinerProxy server TMS protocol port before connecting miners.

TMS3 Linux Installation

Switch to root first:

sudo -i

Run the official GitHub install line:

bash <(curl -s -L https://raw.githubusercontent.com/MinerProxyPro/TMS/main/install.sh)

If GitHub is not reachable from the server, the README also provides this alternate line:

bash <(curl -s -L -k http://cdn.tcminerproxy.com/install.sh)

The installer opens an interactive menu. Choose Install, select the CPU architecture, and then choose the download route.

Common architecture options:

Option Typical device
x86-64 Most Intel/AMD Linux servers and mini PCs.
aarch64 64-bit ARM devices.
arm-musleabi, arm-musleabihf, armv7-* Older ARM devices.

The Linux script installs TMS under /root/tms, configures a service named tmservice on systemd systems, starts the program, and prints the access address after startup.

TMS3 Windows Installation

TMS3 provides two Windows builds.

Build Download
GUI version https://github.com/MinerProxyPro/TMS/raw/main/windows-gui/tms.exe
Command-line version https://github.com/MinerProxyPro/TMS/raw/main/windows-no-gui/tms.exe

If the GUI version opens to a blank white screen, install Microsoft Edge WebView2:

https://github.com/MinerProxyPro/TMS/raw/main/windows-gui/MicrosoftEdgeWebview2Setup.exe

After starting the Windows client, open the TMS page from the local machine or LAN and continue with setup and pairing.

First Access After Installation

After installation, open a browser and visit:

http://DEVICE_IP:42703

Then enter the push address if your deployment provides one, or skip the push flow and add remote server addresses manually.

Recommended first checks:

  • The TMS page opens from another device in the LAN.
  • The device IP is fixed.
  • The TCMinerProxy server TMS protocol port is reachable.
  • The local TMS client and server port use the same TMS protocol generation.

Managing The Linux Script

Running the Linux install script again opens the management menu. The script supports:

  • Install.
  • Stop TMS.
  • Restart TMS.
  • Uninstall TMS.

Use the script menu for normal maintenance unless your deployment has wrapped TMS with its own service manager.

Next Step

After TMS is installed and reachable, continue to setup and pairing.