Point your rigs at the pool in one command.
Choose the path that fits the rig: existing solo miner, brand new rig, or optional managed upkeep. Manual Stratum settings stay below.
Quick connect
Worker names must start with a BTX payout address. Use YOUR_BTX_ADDRESS.luca-8x, not luca 8x. Labels should use letters, numbers, and hyphens, with no spaces.
Install paths
Already solo mining
For rigs that already run exactly one active BTX solo miner. The installer reads the current solo payout address, pauses solo mining while pool mode is active, and starts the performance pool miner.
$curl -fsSL https://poolbtx.com/join.sh | bash -s -- --wallet auto --prompt-worker --pause-solo --start
- Best for existing physical 5090s that already solo mine.
- Prompts for a friendly dashboard name, or Enter keeps the unique default.
- Fails closed if it cannot find exactly one solo payout address.
- Does not touch wallet files, blocks, chainstate, or node config.
- Reports if GPU sensors are hidden from WSL instead of silently losing util / watts / temp.
- Miner self-update stays enabled by default; add
--no-auto-updateonly when intentionally pinning a frozen binary.
Brand new rig start
For a machine that is not already solo mining, a new host, or any time you want to choose the payout address explicitly.
$curl -fsSL https://poolbtx.com/join.sh | bash -s -- --wallet YOUR_BTX_ADDRESS --prompt-worker --pause-solo --start
- Create or choose your BTX wallet first. The pool pays to the address you put here, and poolbtx.com never creates, stores, or controls your wallet.
- Replace
YOUR_BTX_ADDRESSwith the payout address for that machine. - Prompts for a friendly dashboard name, or Enter keeps the unique default.
- Apple Silicon Macs use this explicit-wallet path; the installer uses the upstream Metal backend and writes local start, stop, and status scripts. Stop any Mac solo miner manually if one is already running.
- Best for new rigs, clean servers, and machines where auto-detect is uncertain.
- Same high-performance path and same read-only telemetry.
- Status output includes the GPU telemetry probe path and any sensor error.
- Miner self-update stays enabled by default; add
--no-auto-updateonly when intentionally pinning a frozen binary.
Hand off upkeep (managed)
Optional opt-in for miners who would rather let poolbtx.com keep the pool-miner package current. The same join, with managed updates switched on.
$curl -fsSL https://poolbtx.com/join.sh | bash -s -- --wallet YOUR_BTX_ADDRESS --managed --prompt-worker --pause-solo --start
- Pulls approved updates for the isolated pool-miner wrapper, solver path, telemetry, and pool fixes.
- Miner self-update is also enabled by default, so stable upstream miner updates can land without waiting for a new join command.
- Opt-in and reversible. You keep control of the machine.
- Never grants wallet, chainstate, block-file, node-config, or shell access.
- Pool-only miners do not need a local BTX full node. Managed updates only cover the pool miner, solver, telemetry, and pool fixes.
- Already mining in another pool? Add
--switch-poolto intentionally stop the old pool miner before poolbtx starts. - If a rental host blocks outbound port
3333, the installer automatically tries the rescue Stratum endpoint on134.199.159.114:443. - Multi-GPU hosts are auto-detected. An 8x rental starts eight pool lanes under the same payout address and dashboard machine label.
Good to know
The payout address is the part before the dot in the Stratum worker. The dashboard rolls lanes up into one row per machine, so you track real rigs, not internal worker lanes.
Check a rig with /opt/btx-pool/status.sh. A heartbeat appears quickly; full GPU numbers can take the first sampling minute. Stop or restart with /opt/btx-pool/stop.sh and /opt/btx-pool/start.sh.
Prefer to configure a miner by hand? Use host poolbtx.com, port 3333, worker ADDRESS.rig-name, password x. If the host blocks 3333, use host 134.199.159.114, port 443. Do not use port 333 or a label-only worker name.