Introduction
To set up a Bitcoin mining worker on ViaBTC, enter the BTC pool URL and a worker name in userID.workerID format in your ASIC miner’s pool settings, then save the configuration. ViaBTC automatically creates the worker entry after detecting mining activity from the correctly configured miner—you do not need to create it manually on the website.
This guide covers standard BTC pool mining, including worker naming, primary and backup connections, and checking that your miner is submitting shares. Smart Mining uses different connection settings and is outside this guide’s scope.
What Is a Mining Worker?
A worker identifies a miner or mining instance within a pool account. Assigning a distinct worker ID to each device makes it easier to monitor individual machines and investigate problems.
In ViaBTC’s BTC configuration, the full value entered in the miner’s worker field has two parts:
userIDidentifies the ViaBTC account that receives credit for submitted work.workerIDlabels the device or mining instance within that account.
The full worker name is not a Bitcoin wallet address. Withdrawal settings are configured separately in ViaBTC. Changing only the worker-ID suffix does not change those settings, but changing the account portion changes the account identifier under which the miner submits work. Check both parts before saving.
ViaBTC Worker Name Format for BTC Mining
ViaBTC’s BTC Mining guide specifies this format:
userID.workerID
The guide uses viabtc.001 as an example. The worker-ID portion must contain only lowercase letters and numbers and must not exceed 64 characters.
For example:
youruserid.asic01
youruserid.rack1a
youruserid.s19jpro02
Replace youruserid with your actual ViaBTC account identifier. Choose a worker ID that helps you recognize the device, and use a different ID for each miner you want to monitor individually.
These rules are taken from the BTC setup guide. For another coin, check its own official mining instructions.
What You Need Before Starting
Have the following ready:
- A ViaBTC account and its account identifier
- A Bitcoin-compatible ASIC miner with working network access
- A worker ID that meets the naming rules
- The miner’s local IP address and administrator login
- The official BTC pool connection details
Check the current endpoints on ViaBTC’s Mining Pools Information page before configuration. Use official connection details rather than copying an unverified address from a third-party post or screenshot.
How to Configure the Worker on Your ASIC Miner
Menu names vary by manufacturer and firmware, but the basic process is similar:
- Open the miner’s local IP address in a browser on a network that can reach it.
- Sign in to the miner’s administration interface.
- Open the pool settings, often labeled Miner Configuration, Pool, or Pools.
- Enter the BTC pool URL and your full worker name in the first pool row.
- Complete the mining password field if required.
- Add a backup connection if the miner supports multiple pool rows.
- Select Save & Apply, or the equivalent option, and allow mining to start.
ViaBTC’s documented primary BTC connection can be entered as follows:
URL: stratum+tcp://btc.viabtc.io:3333
Worker: youruserid.asic01
Password: x
Replace youruserid with your actual account identifier; asic01 is an example worker ID.
ViaBTC says the mining password is optional and may be set to any value. Here, x is an arbitrary example for interfaces that require a non-empty field. Follow any firmware restrictions, and do not enter your ViaBTC account login password in this field.
Add a Backup Connection
ViaBTC recommends configuring multiple ports for connection resilience when the miner supports them. Its documented BTC failover port is 443:
URL: stratum+tcp://btc.viabtc.io:443
Worker: youruserid.asic01
Password: x
Use the same account and worker ID for the same device in both entries. The miner’s firmware controls when it switches to a backup and whether it returns automatically to the primary connection.
Additional regional and SSL endpoints are listed on the official Mining Pools Information page. Use them only when supported by your miner and network configuration.
How to Check That the Worker Is Online
Once the miner starts submitting work, ViaBTC detects its activity and creates the worker entry automatically. To check it, sign in to ViaBTC, open Pool → Workers, and make sure you are viewing the intended account and BTC pool. See ViaBTC’s worker-management guide for the dashboard workflow.
Check both the miner and the pool:
- On the miner: Look for a live pool connection, non-zero local hashrate, and accepted-share activity.
- On ViaBTC: Find the expected worker and check that it reports activity and hashrate under the correct account.
ViaBTC’s BTC guide suggests checking the Workers and Earnings pages after roughly 10–15 minutes of stable operation. Its offline-worker troubleshooting guide allows 10–20 minutes depending on hashrate. Treat these as approximate observation windows, not guaranteed appearance times.
If the miner shows a connection error or no accepted shares, start checking the configuration and network immediately rather than waiting for the dashboard to update.
Common Worker Setup Issues
| Issue | Possible cause | Recommended action |
|---|---|---|
| Worker does not appear | Mining has only just started, the wrong account or coin is selected, or the miner is not submitting work successfully | Confirm the dashboard account and BTC selection; check the worker name, local connection status, and accepted shares; allow time for reporting |
| Miner cannot connect | Incorrect hostname or port, network trouble, or an unsupported connection type | Compare the URL with the official endpoint list, check network access, and confirm firmware compatibility |
| Activity is missing from the intended account | Incorrect account identifier in the worker field | Correct the portion before the period, save the settings, and verify activity under the intended account |
| Rejected shares persist or increase | Network latency or instability, stale work, firmware, configuration, or hardware issues | Review rejection messages and connection quality; check firmware and miner conditions; contact ViaBTC support if the issue persists |
| Several miners are difficult to distinguish | Devices share the same worker identity | Assign each device a distinct worker ID and verify its activity separately |
A rejected share does not by itself identify the cause. Use the miner’s messages and pool data together to investigate. ViaBTC’s rejection troubleshooting guide covers network, temperature, and firmware checks.
Conclusion
Setting up a BTC worker on ViaBTC starts with the correct pool URL and userID.workerID value in your miner’s configuration. Add a backup connection where supported, save the settings, and confirm accepted shares locally and worker activity on ViaBTC. Clear, distinct worker IDs make ongoing monitoring easier, while checking the account identifier and connection details helps resolve common setup problems.
FAQ
Do I need to create a worker on the ViaBTC website first?
No. Configure the pool URL and worker name on your miner. ViaBTC automatically creates the worker entry after detecting mining activity from the correctly configured device.
What format should I use for a BTC worker name?
Use userID.workerID, such as youruserid.asic01, replacing youruserid with your actual account identifier. The worker-ID suffix must use lowercase letters and numbers and be no longer than 64 characters.
Is the worker name the same as my wallet address?
No. The account portion identifies the account receiving credit, and the worker-ID suffix identifies the miner within that account. Withdrawal addresses are configured separately. Changing only the suffix does not change withdrawal settings.
What password should I enter?
ViaBTC allows any mining password and makes the field optional. If your miner requires a value, x is an example, subject to firmware restrictions. This is not your ViaBTC account login password.
How long does it take for a new worker to appear?
Allow roughly 10–15 minutes of stable operation before checking the dashboard. ViaBTC’s offline-worker guidance also mentions an observation window of 10–20 minutes depending on hashrate. If the miner reports errors or no accepted shares, investigate those immediately.
Can multiple miners use the same worker ID?
Devices sharing the same full worker identity can have their activity aggregated under one entry, making individual machines harder to monitor. Use a distinct ID for each device when you want separate visibility, as explained in ViaBTC’s worker-monitoring article.
References
- ViaBTC Help Center — BTC Mining
- ViaBTC Help Center — Mining Pools Information
- ViaBTC Help Center — How to Manage Workers
- ViaBTC Help Center — Offline or Inactive Workers While the Miner Is Working
- ViaBTC Help Center — What if the Rejection Rate Is High?
- ViaBTC Blog — How to Use a Pool App or Dashboard to Monitor Multiple Workers


