home · downloads · knowledge base · changelog · team · pool · support · contact
asicseer logo
ASIC management and monitoring system that installs directly onto Bitmain© hardware.

Table of Contents

Quick Start Guide

ASICseer is separated into read-only and read-write. Your Panel is read-only and your Remote Config File is read-write.

  1. Go to ASICseer Downloads, a Remote Config File will automatically be generated and hosted on ConfigMaker for you.
  2. Save or bookmark your "Secret Config Editor", you will need it to manage all of your ASICs.
  3. Follow the instructions under "Simple and Easy Installation" and wait for the installation to complete.
  4. After the installation finishes, visit the "Miner Configuration" page on your ASIC.

You can use "Powerful and Advanced Installation" to quickly install ASICseer on multiple units via SSH.

Using ConfigMaker for your Remote Config File

  1. Go to ASICseer Downloads to automatically generate a Remote Config File.
  2. Save or bookmark your "Secret Config Editor", you will need it to manage all of your ASICs.
  3. Set your custompanel (optional, but recommended), and edit the config to suit your preferences.
  4. Make changes to your ConfigMaker config to manage your ASICs.

Setting up your own Remote Config File

If you don't want ConfigMaker to host your Remote Config File, you can host it yourself on a world-reachable remote server, vps, or shared hosting account that you control.

  1. Copy https://asicseer.com/config.txt and host it yourself on a world-reachable remote server, vps, or shared hosting account that you control.
  2. Get the link to your Remote Config File like http://your-server.com/config.txt
    NOTE: The link http://your-server.com/config.txt is an example. You must use your own link.
  3. Set your custompanel (optional, but recommended), edit the config to suit your preferences.
  4. Make changes to your remotely hosted config to manage your ASICs. See Writing your Config for documentation.
  5. Paste the link to your Remote Config File into the "Remote Config File" field on the Downloads page and click "Regenerate Downloads."

Using the multi-ASIC installer

  1. Add your vlans into your Remote Config File (example). Each vlan must be specified like: (last octet is a range).
  2. Add your ASIC root password (usually "admin") into your Remote Config File as shown in the example.
  3. sudo su to become root. You must actually be root to run this installer.
  4. echo -n "" > /root/.ssh/known_hosts to clear possible re-used IP addresses.
  5. Install nmap sshpass awk sha256sum curl if your linux box doesn't have them installed.
    • ubuntu, debian example: apt-get -fy install nmap
    • ethos example: apt-get-ubuntu -fy install nmap
    • fedora, centos example: yum -y install nmap
  6. Follow the Quick Start Guide to generate your installer script.
  7. Copy/paste the line under "MULTI-ASIC INSTALLER" into your linux box and press ENTER.
  8. Wait for the installation process to start.
  9. The installer output will fill your screen. Once there is no output to your screen (you can check by pressing ENTER), the installation is finished.

Writing your Config

Your entire farm can be controlled with a single Remote Config File. Your Remote Config File is downloaded and applied to your ASIC every 10 minutes, so any changes can take up to 10 minutes to take effect.

For faster responsiveness (every 2 minutes instead of 10 minutes), host your own Remote Config and add RESPONSIVE to your config filename (example: http://your-server.com/configRESPONSIVE.txt)

See https://asicseer.com/config.txt for an example config. Everything with a hashtag/poundsign is a comment, and is ignored by all scripts. All config settings, except for usernames, wallets, and passwords, are always lowercase.

The format for writing your config is asicid setting value where:

Use global for the asicid to apply a setting to all ASICs on which you have installed the same Remote Config File.

poolname2,username2,poolpass2,sendworker2andpoolname3,username3,poolpass3,sendworker3 are the 2nd/3rd pools.

location can only only be applied to individual ASICs, you cannot use global or group for this location.

ab34ef is an example asicid name (use your own asicid names here, one per line).

group searches location for a string and applies your setting to any ASIC location that has a match. The below example will reboot ASICs with a location that has rowc in it, and will stop mining on ASICs with a location that has rowd in it.

# group=rowc rebootasic 1
# group=rowd allowed no

Customizing your Worker Name / Location

You can use one remote config for all ASICs. Even if you want to specify multiple workers, you don't need a different remote config per ASIC. To switch your worker name and assign a location, follow the below guide.

  1. Do not add a newname to your wallet like wallet.newname, this will not work.
  2. In your config, set asicid location newname (asicid is your original 6-digit worker name and newname is your new worker name).
    example: ab34ef location rowc2 as shown in the sample config.
  3. Do not use very long newname. The maximum length is 12 characters.
  4. Do not use the same newname for multiple ASICs.

After this procedure, your pool will see your new worker name, and your ASIC will have a new location assigned on your Panel.

Assigning Worker Names / Locations Automatically

If you use hostnames to manage your worker names and ASIC locations, ASICseer will use them to set Worker Names / Locations during installation.
If you have a big farm and don't know where any of your ASICs are located, ASICseer makes it easy to find them.

NOTE: It is important to do the below steps when your Internet is stable, and your ASICs are online and reporting.

  1. After installing ASICseer, go to your Panel. Then, physically go to your first Rack ("Rack A") and decide on an order for them.
  2. Reseat the ethernet cables on ("Rack A") ASICs in order, one by one (unplug AND replug, wait at LEAST 15 seconds, replug, then go to next ASIC).
  3. Wait at least 3 minutes.
  4. Your Panel will show a number in the "i" column (seconds ago that your ASIC's Internet connection reestablished).
  5. Select "assign workers" from the dropdown menu and click the "submit" button.
  6. Set your worker names like: a1,a2,a3...
  7. Continue doing this for all rows and racks. As long as you reseat all ASICs in the order you prefer, ASICseer will order them correctly.

Assigning Worker Names / Locations with REGEX

If you use static IPs for your ASICs, you can use regex to assign IP octets for your worker name and location.

  1. After installing ASICseer, go to your Panel.
  2. Select "config template" from the dropdown menu and click the "submit" button.
  3. Copy and Paste the config template into the "TEST STRING" field of regex101.com's regex editor.
  4. Copy and Paste the resulting "SUBSTITUTION" result into your Remote Config and save it.

After 10 minutes, all your ASICs will have downloaded and applied the new config settings, the new locations will be set on your Panel, and the new worker names will be sent to your pool.

Managing Temperature

If the average chip temperature per hashboard exceeds maxtemp, the miner will turn off until you reboot or reset the ASIC.

Follow the below steps to reduce the chances of your ASICs overheating:

Setting a Custom Panel

ASICseer assigns a 6-character Panel based on a hash of your external IP. This way, all ASICs on one network can report to the same Panel.

If your public IP changes, your Panel will change.

You can set your own Custom Panel with the custompanel parameter.

NOTE! After any changes to custompanel wait 15 minutes for it to update, or run putconf; sleep 2; update; on the ASIC.

Deleting/Removing ASICs from your Panel

ASICseer is separated into read-only and read-write. Your Panel is read-only and your Remote Config File is read-write.

You cannot request the Panel to delete data if your ASIC is down. There are only two options for removing ASICs from your Panel:

Using API endpoints to load JSON DATA with Google Docs

The following API endpoints can load historical monthly per-Panel and per-asic data, useful for enterprise-class customer billing purposes.

  1. Open Google Docs and go to Tools -> Script Editor
  2. Paste the below function into the Script Editor for Code.gs
    function readJSON2(inV) {
    var jsonStringResponse = UrlFetchApp.fetch(inV);
    eval("object ="+jsonStringResponse.getContentText());
    var outA = new Array(); var h = 0;
    for ( var j in object ) { outA[h] = object[j];h++;}
    return outA }
  3. Save your changes.
  4. Add, for example, =readJSON2("https://asicseer.com/api/panel-kwh/asdemo/05") to any cell.

Using Nicehash for mining without a Pool Account

If you don't want to set up any pool accounts, you can use Nicehash.

  1. Replace the pools in your config with the below stanza.
  2. Replace the predefined stratum server locations if necessary.
  3. Your username is your wallet address, replace it with your own wallet address.
global poolname1 sha256.usa.nicehash.com:3334
global username1 15tXyQAYyiD4q1FUVcsdMgG78fFZG6J9zD
global poolpass1 x
global sendworker1 yes
global poolname2 sha256.eu.nicehash.com:3334
global username2 15tXyQAYyiD4q1FUVcsdMgG78fFZG6J9zD
global poolpass2 x
global sendworker2 yes
global poolname3 sha256.hk.nicehash.com:3334
global username3 15tXyQAYyiD4q1FUVcsdMgG78fFZG6J9zD
global poolpass3 x
global sendworker3 yes

Using SSH to Login to ASICs from Windows

  1. Connect your computer to the same network as your ASICs.
  2. Download Putty from http://the.earth.li/~sgtatham/putty/latest/x86/putty.exe.
    Putty is an executable that can be run without installing.
  3. Find the IP of your ASIC.
    You can find your ASIC IP on your asicseer.com Panel or on your router's DHCP client table.
  4. Open Putty and input ASIC Information.
    Type the ASIC's IP into Host Name. Port should be 22. Click Open.
  5. Login to ASICseer terminal.
    When the terminal window shows up, login with username root, password admin.
  6. A list of available commands will appear.

Pasting Text: In Windows, CTRL+C to copy text. In putty, SHIFT+INSERT to paste it.
To SSH remotely: Connect to a dedicated VPN box on your ASIC network using your favorite vpn software.

List of Common ASICseer Terminal Commands

ASICseer | available commands:

dmesg		show kernel log
helpme          show this list of commands
gethelp         generate a diagnostics file for getting support
df | p          send output of piped (ex: df) to paste server
update          force a stats update to the panel server
putconf         redownload the contents of your remote config
rawstats        display non-formatted system info / miner stats
jsonstats	display json-formatted system info / miner stats

Restoring your ASIC to factory settings

Bitmain's latest firmwares restrict your ability to SSH to your ASIC. For now, if you need to restore your ASIC to factory settings, instead of upgrading to the latest firmware, use the "Restore via IP Report Button" functionality as described on Point 3 of Bitmain's factory restore guide.

Please also contact Bitmain and kindly let them know how important it is for you to have software that does not place limits or restrictions on your ability to interact with your purchased hardware.

Identifying Faulty Hashboards

Many people who install ASICseer are surprised to see faulty hashboards. These faulty hashboards existed before you installed ASICseer, you just did not know about them. You can verify this by checking your pool-side hashrate for any individual worker.

If your ASIC has identified a faulty hashboard, it will show a 🔗 or 🔘. You can identify the faulty hashboard using the Panel and the [ | ] hashboard detection symbols.

The below symbols identify which hashboard is detected and working fine from the exhaust side.

If your ASIC shows a 🔗, it indicates a high chain xtime.

If your ASIC shows a 🔘, it indicates a broken hashboard.

Joining #asicseer-help IRC Channel

Free 24/7 support: Free lifetime support 24/7 via the #asicseer-help IRC channel.

Using your Web Browser

  1. On your regular PC or computer, visit #asicseer-help (this opens in a new window)
  2. Enter a nickname for yourself.
  3. Do not change the "channels" field.
  4. Do not checkmark "auth to services".
  5. Checkmark "i'm not a robot".
  6. Click connect and wait up to 15 seconds to connect to the IRC channel.

Using your IRC Client

Channel: #asicseer-help
Server: irc.asicseer.com
Port: 6667

Contacting the ASICseer Team

Please direct all Media and Business inquiries to info@asicseer.com

Emails requesting technical support will be treated as spam. For support, see #asicseer-help IRC channel.

Uninstalling ASICseer

Simple and Easy Uninstallation

  1. Download the correct Bitmain firmware for your ASIC.
    NOTE: Be careful, any firmware described as having a "security firmware feature" prevents SSH to your ASIC.
  2. Navigate to your ASIC's firmware upgrade page and upload the Bitmain firmware to your ASIC.

Powerful and Advanced Uninstallation

Use the word "uninstall" as your remote config file for /flash/ and /netflash/ installers like:
      curl -s -k https://asicseer.com/flash/a/uninstall | ash

NOTE: This will restore all settings and pools to factory settings.

© 2019 ASICshack, LLC. All rights reserved.