Bitseed

Shopping Cart: $0.00 0 items

From the blog

Bitseed Bitcoin Edition – Quickstart Guide

Using Bitseed v2 Bitcoin Edition
This device is delivered with bitcoind installed
and the blockchain synchronized up to the date of shipment.

Information and updates can be found at bitseed.org/blog.

Basic Use

  • Connect the device to your router using the provided Cat5 Ethernet cable.
  • Plug in the power adapter and connect to the USB power port on the device (it is labeled 5V on the top cover above the connector).
  • Once powered, the device will automatically start bitcoind within 2 hours. Bitcoin will catch up with the current block height and then run continuously, hosting a full bitcoin node.
  • It is best to keep Bitseed running 24 hours per day.


Accessing the device

Status and Admin Panel via Browser

  • The device has a web browser accessible interface.
  • The local network ip address can be discovered by logging into your router and finding the list of network devices. It will have the format xxx.xxx.xxx.xxx.
    • IP address scanning tools such as Angry IP scanner may be helpful – http://angryip.org/
    • The hostname of the device is “bitseed”


  • The device hosts two web pages:
    • A simple status page on port 80. This page has basic status info and can be displayed publicly. http://[ip.add.re.ss]:80
    • A full admin panel on port 81, which includes menus that allow more detailed status info and controls. This is intended to be kept private. http://[ip.add.re.ss]:81

SSH Access

  • You can access the device via SSH.
  • Username and Password are on the bottom of the device.
  • Browse to your router’s control panel to see what IP address the Bitseed device is using. Instructions for accessing your router’s control panel are available from your ISP and/or included in the box for your router. The network host name of the device is “btc.”
  • Linux command line: ssh linaro@{paste device IP address here then press enter}
  • Putty is a good Windows app for SSH.

Direct access via monitor, mouse and keyboard

  • The device can be connected to an HDMI monitor with the HDMI input.
  • A USB mouse and USB keyboard can be connected.
  • The Ubuntu operating system provides a GUI, and you can open a terminal window to enter commands.
  • Bitseed scripts will not run from the GUI. Access the command line via a terminal window.

Shutting down the device

The best way to shutdown the device is to stop bitcoind first. This avoids potential blockchain database corruption. The status panel has a shutdown button.

Or, at the command line enter:

./btcstop.sh

Wait until the script says bitcoin has stopped, then enter:

 shutdown -h now

System Configuration

  • The latest version of Bitcoin Core as of the ship date is installed
  • The OS is installed on the 4GB internal NAND flash
  • The hard drive is mounted as /home/linaro


Advanced Use

Scripts

The device contains some scripts that may be useful

./blockstatus.sh – current highest synced block

./btcstop.sh – stop bitcoind

./btcinfo.sh – basic status

./btcwatch.sh – watch dog script, run bitcoind if not running

Bitseed run several scripts automatically. These are initiated via

crontab -e

and

sudo crontab -e


Port 8333 for Bitcoin peer connections

Bitcoin uses port 8333 to connect with other nodes. To allow other nodes to find your node, Bitcoin will attempt to open port 8333 of your router using the UPnP protocol. If UPnP is not enabled, then the node will only have eight peers. If no more than eight peers are connected, check that UPnP is enabled in the router. If UPnP is not supported, you can manually open port 8333 with the router port forwarding controls.


Other notes

  • It is best to keep the device running 24/7. If the device is offline for weeks or months, it could take many days for it to catch up with the current block height.
  • The automatic scripts will make a full backup of the blockchain database every day. Bitcoind will shutdown for about 30 minutes each week during backup and then restart.
  • A power outage or hard shutdown can cause the blockchain database to report an error. If this happens, the device will delete the damaged database and restore it from backup. This takes about an hour and should occur automatically.
  • If for some reason the restore fails, bitcoind can build a new blockchain from scratch, but this will likely take about 1-2 weeks due to the large size of the Bitcoin blockchain.

Subscribe to our newsletter at https://bitseed.org/subscribe/ for Bitseed announcements, news, and updates.

Leave a Reply

Your email address will not be published. Required fields are marked *