How to Set Up a Mining Pool on an Antminer: Step-by-Step Guide
2026-11-15 09:46

An Antminer joins a mining pool through its local web interface rather than through any pool-side action. The operator locates the miner's IP address, signs in to the device dashboard, enters a pool's Stratum URL together with a worker name and optional worker password, saves the configuration, and then confirms that the pool is receiving shares from that worker. This guide covers that configuration process for a Bitcoin SHA-256 Antminer, such as an S19 or S21 series unit, connecting to a BTC pool. Antminer product lines support different algorithms and coins, so the fields and connection details described here apply specifically to BTC mining rather than to every Antminer model.

Throughout this guide, a worker name is used only to identify a specific miner within a pool account; it is not a Bitcoin payout address, and entering it incorrectly does not expose funds, though it will prevent shares from being credited correctly.

What You Need Before Connecting an Antminer to a Pool

Before opening the miner's web interface, confirm the following:

  • An Antminer model compatible with the coin and algorithm to be mined (BTC mining requires a SHA-256 Antminer, such as an S19 or S21 unit).
  • A power connection meeting the unit's rated specifications and an Ethernet connection to a local network.
  • A computer or mobile device connected to the same local network as the miner.
  • An active mining-pool account and the account's user ID.
  • Current connection details copied directly from the pool's official documentation, since Stratum URLs and ports can change over time.

Step 1: Find Your Antminer's IP Address

The miner must first be identified on the local network. Bitmain documents an IP Reporter tool for this purpose on several Antminer models; the computer running the tool and the miner must be on the same local network for the discovery process to work. Some network environments also allow the IP address to be found through the router's connected-device list. Once identified, the IP address is entered into a web browser to reach the miner's configuration interface.

Step 2: Log In to the Antminer Web Interface

Opening the miner's IP address in a browser loads a login screen. The relevant settings area is not labeled identically across all Antminer models and firmware versions: older documentation, including Bitmain's S17/S17 Pro setup guide, refers to a Miner Configuration screen, while newer interfaces such as the one described in Bitmain's S21 User Guide use a Settings menu.

Login credentials also vary by model, production batch, firmware version, and whether the unit has already been configured by a previous owner or operator. Rather than relying on a generic default password, consult the manual supplied with the specific Antminer model, and change the device-access credentials where the firmware supports it.

Step 3: Enter Mining Pool Settings

Once logged in, the pool-configuration screen requests three fields:

  • Pool URL / Mining Address — the Stratum server address the miner connects to.
  • Worker / Miner Name — typically formatted as userID.workerID, identifying both the pool account and the individual device.
  • Password — a worker password, or a placeholder value required by some firmware. This field is not the pool account's login password.

For a ViaBTC BTC connection, ViaBTC's BTC mining documentation specifies the worker-name format as userID.workerID, with the worker-ID portion limited to lowercase letters and numbers, up to 64 characters. An example configuration, using a fictional account and worker label, is shown below:

Pool 1 URL: stratum+tcp://btc.viabtc.io:3333
Worker: exampleuser.antminer01
Password: x

Because Stratum URLs and ports are subject to change, copy the current endpoint directly from ViaBTC's mining-pool endpoint directory immediately before configuring the device, rather than from an older or cached source.

Step 4: Configure Backup Pool Entries

Most Antminer firmware provides more than one pool slot, arranged by priority rather than by load balancing. The miner mines against the first available pool in the list; lower-priority entries are used only when a higher-priority pool becomes unreachable, not simultaneously with it. Bitmain's S21 User Guide documents three pool entries with descending priority on that model; other Antminer models and firmware versions may provide a different number of slots, so this figure should not be generalized across the entire product line.

A practical backup configuration might list the same pool account on an alternate port, since ViaBTC documents both a primary and an alternate BTC endpoint:

Pool 2 URL: stratum+tcp://btc.viabtc.io:443
Worker: exampleuser.antminer01
Password: x

As with the primary entry, confirm any backup port or hostname against the pool's current documentation rather than assuming it remains unchanged.

Step 5: Save Settings and Verify Mining

After entering the pool details, click Save, Save & Apply, or the equivalent control for the installed firmware. The miner will restart its mining process and attempt to connect to the configured pool.

On the miner's dashboard or status page, check for a successful pool connection, accepted-share activity, hashboard status, and operating temperature. ViaBTC's BTC mining guide suggests allowing roughly 10–15 minutes after the miner stabilizes before checking pool-side activity and earnings; this is a practical observation window rather than a guaranteed connection time, since network conditions and device startup behavior vary. Once this period has passed, confirm that the worker name appears as active in the pool's dashboard under the corresponding account.

Why Pool Hashrate and Antminer Hashrate May Differ

The hashrate shown on the miner's local display and the hashrate shown in the pool account are related but distinct measurements, calculated over different windows. According to ViaBTC's documentation on this topic, the pool's real-time hashrate is calculated from shares submitted over the preceding 10 minutes, while the pool's daily hashrate reflects the preceding 24 hours. A miner that has been running only briefly will not yet have a full 24-hour history, which can make its pool-side daily figure appear lower than its local display, even though the device is operating normally. For this reason, compare local and pool-side readings only when their respective measurement windows are taken into account, rather than treating a momentary difference as evidence of a misconfiguration.

Common Antminer Mining-Pool Setup Problems

Most connection failures trace back to a small number of causes:

  • An incorrect Stratum URL or port number, often from an outdated or mistyped endpoint.
  • An incorrectly formatted userID.workerID value, including mismatched capitalization or disallowed characters.
  • The miner connecting to a backup pool entry instead of the intended primary pool, usually because the primary entry was unreachable at startup.
  • Local network issues, including faulty cabling, a misconfigured switch, DNS resolution failures, or router restrictions.
  • Elevated operating temperature or a firmware compatibility issue affecting hashboard stability.
  • Entering a pool URL into a wallet-address field, or vice versa; the two values serve entirely different functions and should never be interchanged.

If accepted shares are registering but the rejection rate appears unusually high, ViaBTC's rejection-rate troubleshooting guide characterizes a rate within roughly 3% as typical under normal operating conditions; this figure reflects ViaBTC's own operational guidance rather than a fixed industry-wide standard, and persistent rejection above that range generally points to network latency or configuration issues worth investigating.

Optional: Choosing a Payout Method

The payout method applied to mined shares is an account-level setting within the pool, and it does not change any of the Antminer's connection fields — the Stratum URL, worker name, and password remain the same regardless of which method is selected. ViaBTC's payout-method documentation describes two common approaches: under PPS+, the block-reward component of earnings is paid according to Pay-Per-Share rules based on submitted shares, while the transaction-fee component is allocated using Pay-Per-Last-N-Shares (PPLNS) rules. Under PPLNS alone, payouts depend on the blocks the pool actually finds during a given set of rounds, meaning realized earnings can vary with the pool's short-term luck. Reviewing the payout method is a separate decision from the device-configuration steps described above, and it can typically be changed within the pool account without altering the miner's settings.

Closing Notes on Firmware and Maintenance

Firmware should be obtained only through the manufacturer's official download channel for the specific Antminer model. Bitmain's S21 User Guide notes that an interrupted power supply during a firmware upgrade can leave the device in a state that requires repair, so upgrades should be performed on a stable power connection and should not be interrupted once started. For ongoing monitoring after setup, ViaBTC also offers configurable hashrate and rejection-rate notifications at the account level, which can alert an operator to a stalled worker or abnormal share behavior without requiring manual dashboard checks.

FAQ

Is the worker name the same as my Bitcoin wallet address?

No. The worker name, typically formatted as userID.workerID, identifies a specific device within a pool account. It is entered in the Antminer's pool-configuration screen and has no connection to a Bitcoin payout address, which is configured separately within the pool account itself.

Does the password field require my pool account password?

No. The password field in the Antminer's pool settings is a worker password or firmware placeholder value, not the login password for the pool account. Entering the account password here does not grant additional access and is unnecessary.

Why does my miner show a different hashrate than the pool dashboard?

The miner's local display and the pool's hashrate estimate are calculated over different time windows. A newly started worker, in particular, may not yet have enough history for the pool's 24-hour daily figure to match its local reading.

Can I mine on two pools at the same time by filling in multiple pool slots?

No. Backup pool slots are priority-based failover entries. The miner uses a lower-priority pool only when a higher-priority one becomes unreachable, not simultaneously with it.

Where should I get my pool's current connection details?

From the pool's official documentation immediately before configuring the device, since Stratum URLs and ports can be updated over time.

References