How to install and configure Bitcoin Unlimited (on Ubuntu 15.10 desktop)

steffen

Active Member
Nov 22, 2015
118
163

freetrader

Moderator
Staff member
Dec 16, 2015
2,806
6,088
From the looks of it, the archive's structure is such that you would be able to unpack it in the root directory of your system, and then run the executables as any user (e.g. from a personal account).
Since /bin is in a normal user's path usually, you should be able to just run the client (bitcoin-qt), which would presumably create the .bitcoin directory in the usual home directory of the user who is running it.
(Note: you might need to create ~/.bitcoin yourself if need be)

There is a daemon (bitcoind) which would be of interest if you are setting up to run a node.
You might find the script bitcoinAutoNode.sh from https://github.com/XertroV/BitcoinAutoNode to be useful if you're going to look at doing that.
 
  • Like
Reactions: steffen

steffen

Active Member
Nov 22, 2015
118
163
Thank you for your answer.

From the looks of it, the archive's structure is such that you would be able to unpack it in the root directory of your system
If I attempt to extract the file to \ using the GUI tool Archive Manager I get this message:
Extraction not performed
You don't have the right permissions to extract archives in the folder "file:"

There is a daemon (bitcoind) which would be of interest if you are setting up to run a node.
You might find the script bitcoinAutoNode.sh from https://github.com/XertroV/BitcoinAutoNode to be useful if you're going to look at doing that.
The script seems to have been designed for bitcoinxt.

I am still looking for a simple step-by-step guide for installing Bitcoin Unlimited. Some of us don't come with a programming background.
 
  • Like
Reactions: freetrader

freetrader

Moderator
Staff member
Dec 16, 2015
2,806
6,088
You need superuser (root) access on your Ubuntu box to install it in the root directory.
I'll assume you have that, so open a terminal as root, change to the root directory and unpack the archive using the 'tar' command:

Code:
# cd /
# tar  -xv --strip-components=1 -f /path/to/bitcoinUnlimited-0.11.2-linux64.tar.gz
You should see the files being extracted.

Close the root shell, and log in to your regular user account, create a .bitcoin subdirectory in your home directory.

You should be able to run the "bitcoin-qt" program, assuming /bin is in your PATH.
If not, you are probably still missing some packages on which the Bitcoin client depends.
You should see some error messages in that case though - please report them if you do.

About the script above: I pointed you to that not in order to simply run it, but to look at the commands it performs, to get an idea of what you might need to install on Ubuntu in terms of prerequisites.
Of course, it's geared to compiling a Bitcoin client from source, but some of the instructions might still be useful in general.

I'm sure the BitcoinUnlimited project will provide better links to information soon.

Bitcoin Unlimited builds largely on the same code that BitcoinXT and Bitcoin Core does, so they have very similar installation requirements and procedures.

Surprisingly, the page at https://en.bitcoin.it/wiki/Help:Installing_Bitcoin_Core does not have any information on installing on Linux in general or Ubuntu specifically. A difference in Bitcoin Core is that there is are Ubuntu packages for it, making it a bit easier to install.
 
Last edited:
  • Like
Reactions: steffen

steffen

Active Member
Nov 22, 2015
118
163
That was what I needed. To get root access I started by entering this command in a terminal:
sudo gnome-terminal
Then I used your commands from that new root terminal.
root@coin-desktop:/# /bin/tar -xv --strip-components=1 -f '/home/coin/Downloads/bitcoinUnlimited-0.11.2-linux64.tar.gz'
bitcoinUnlimited-0.11.2/bin/
bitcoinUnlimited-0.11.2/bin/bitcoin-cli
bitcoinUnlimited-0.11.2/bin/bitcoind
bitcoinUnlimited-0.11.2/bin/bitcoin-qt
bitcoinUnlimited-0.11.2/bin/bitcoin-tx
bitcoinUnlimited-0.11.2/bin/test_bitcoin
bitcoinUnlimited-0.11.2/bin/test_bitcoin-qt
bitcoinUnlimited-0.11.2/include/
bitcoinUnlimited-0.11.2/include/bitcoinconsensus.h
bitcoinUnlimited-0.11.2/lib/
bitcoinUnlimited-0.11.2/lib/libbitcoinconsensus.so
bitcoinUnlimited-0.11.2/lib/libbitcoinconsensus.so.0
bitcoinUnlimited-0.11.2/lib/libbitcoinconsensus.so.0.0.0
root@coin-desktop:/#

When I ran the bitcoin-qt command I got the warnings below but the program started and is right now downloading the blockchain.
libpng warning: iCCP: known incorrect sRGB profile
libpng warning: iCCP: cHRM chunk does not match sRGB

Thank you.
 
  • Like
Reactions: freetrader

steffen

Active Member
Nov 22, 2015
118
163
coin@coin-desktop:~$ dpkg -l | grep libpng
ii libpng12-0:amd64 1.2.51-0ubuntu3.15.10.1 amd64 PNG library - runtime
coin@coin-desktop:~$
 

sickpig

Active Member
Aug 28, 2015
926
2,541
@steffen thanks for the quick reply.

My guess is that there're some issues with broken pngs (image file).

regardless those warnings are harmless.
@theZerg should fix them in the next release.
 
  • Like
Reactions: steffen

theZerg

Moderator
Staff member
Aug 28, 2015
1,012
2,327
Its a good suggestion to have Linux installation instructions. Steffen, unlike windows, you typically do all of you work in your home directory. You probably would have muddled through if you hadn't tried to install it into /...
 
  • Like
Reactions: steffen

freetrader

Moderator
Staff member
Dec 16, 2015
2,806
6,088
Thank you.
You're welcome, and thank you for posting the output of the commands so that others can see.
I didn't have the resources to run up an Ubuntu machine myself, but I'm happy it worked.

I'll add to what theZerg said above about normally installing it in your user's home directory.
That is the correct approach to take on a Linux system, because by installing software in the way you did just now (downloading a binary, installing it as root) can actually damage your system if something goes wrong. Whereas installing it in your home directory you would usually only put your own home data at risk, unless you run it with elevated privileges (i.e. using sudo or similar).

However, when installing something like this in your home directory, you would need to add ~/bin to your PATH or type in ~/bin/bitcoin-qt to run the program.
And it also unpacked files under a "lib/" subdirectory, so these would end up under your home directory, ~/lib. You would then need to tell your system, by configuring LD_LIBRARY_PATH, that it also needs to look in your ~/lib folder to find any libraries that your self-installed program needs, otherwise it would refuse to run. So, that's what theZerg meant when he wrote "muddle" - there's a little more effort to keep things nicely contained under your home directory. It doesn't really matter if it's just a test system, but if you are going to administrate this system for a longer time, it pays dividends in terms of security.
 
Last edited:
  • Like
Reactions: steffen

theZerg

Moderator
Staff member
Aug 28, 2015
1,012
2,327
Note to other linux guys, how about these for instructions:

Download the file and then open a terminal window. Type:
tar xvf ~/Downloads/bitcoinUnlimited-0.11.2-linux64.tar.gz
cd bitcoinUnlimited-0.11.2/bin/
nohup ./bitcoin-qt &


@freetrader, it seems to work fine for me without dealing with LD_LIBRARY_PATH...
 
  • Like
Reactions: steffen

freetrader

Moderator
Staff member
Dec 16, 2015
2,806
6,088
@theZerg

I think your simplified installation instructions for Linux are a good start.
Perhaps later packages based on existing Ubuntu templates etc. could make for easier installation & upgrade for some folks.

According to a quick check using ldd(1), libbitcoinconsensus.so is not required by any of the binaries, so there is indeed no need to fiddle with the library path.

Reading the release notes where it was introduced suggests it is only an interface for external programs and language bindings. I had always assumed they had factored that the consensus stuff out into a dynamic library which is also used by the daemon / GUIs, but it turns out I was mistaken...
 
Last edited:
  • Like
Reactions: steffen

theZerg

Moderator
Staff member
Aug 28, 2015
1,012
2,327
I figured the same, but I thought that the release probably put a default load path in for the lib. Guess we were both wrong. Thx for doing the research
 
  • Like
Reactions: steffen

steffen

Active Member
Nov 22, 2015
118
163
@theZerg, I have found a funny bug in the program. Under Help there is the option "About Bitcoin Core". It should probably have been "About Bitcoin Unlimited".
 
  • Like
Reactions: Peter R

steffen

Active Member
Nov 22, 2015
118
163
When I was only 2 weeks behind I suddenly got this message:

Error: A fatal internal error occurred. See debug.log for details

The end of the log file contains this:
2015-12-24 11:43:14 Acceptable block: ver:4 time:1449733434 size: 996121 Tx:2236 Sig:6775
2015-12-24 11:43:14 Acceptable block: ver:4 time:1449734800 size: 998171 Tx:2598 Sig:5552
2015-12-24 11:43:14 Acceptable block: ver:4 time:1449734800 size: 998171 Tx:2598 Sig:5552
2015-12-24 11:43:14 Acceptable block: ver:4 time:1449734790 size: 53698 Tx:40 Sig:65
2015-12-24 11:43:14 Acceptable block: ver:4 time:1449734790 size: 53698 Tx:40 Sig:65
2015-12-24 11:43:14 Acceptable block: ver:4 time:1449680811 size: 999991 Tx:2030 Sig:5143
2015-12-24 11:43:14 Acceptable block: ver:4 time:1449680811 size: 999991 Tx:2030 Sig:5143
2015-12-24 11:43:14 Acceptable block: ver:4 time:1449681833 size: 999936 Tx:1803 Sig:4151
2015-12-24 11:43:14 Acceptable block: ver:4 time:1449681833 size: 999936 Tx:1803 Sig:4151
2015-12-24 11:43:14 Acceptable block: ver:3 time:1449682888 size: 523523 Tx:1156 Sig:2577
2015-12-24 11:43:14 Acceptable block: ver:3 time:1449682888 size: 523523 Tx:1156 Sig:2577
2015-12-24 11:43:14 Acceptable block: ver:3 time:1449734830 size: 209 Tx:1 Sig:1
2015-12-24 11:43:14 Acceptable block: ver:3 time:1449734830 size: 209 Tx:1 Sig:1
2015-12-24 11:43:14 Acceptable block: ver:4 time:1449736677 size: 929955 Tx:2651 Sig:5143
2015-12-24 11:43:14 Acceptable block: ver:4 time:1449736677 size: 929955 Tx:2651 Sig:5143
2015-12-24 11:43:14 Acceptable block: ver:4 time:1449684695 size: 749100 Tx:2056 Sig:3883
2015-12-24 11:43:14 Acceptable block: ver:4 time:1449684695 size: 749100 Tx:2056 Sig:3883
2015-12-24 11:43:14 Acceptable block: ver:4 time:1449737029 size: 999945 Tx:2358 Sig:4983
2015-12-24 11:43:14 Acceptable block: ver:4 time:1449737029 size: 999945 Tx:2358 Sig:4983
2015-12-24 11:43:14 Acceptable block: ver:3 time:1449685565 size: 933468 Tx:2218 Sig:4787
2015-12-24 11:43:14 Acceptable block: ver:3 time:1449685565 size: 933468 Tx:2218 Sig:4787
2015-12-24 11:43:14 Acceptable block: ver:4 time:1449631053 size: 67831 Tx:171 Sig:363
2015-12-24 11:43:14 Acceptable block: ver:4 time:1449631053 size: 67831 Tx:171 Sig:363
2015-12-24 11:43:14 Acceptable block: ver:4 time:1449631053 size: 67831 Tx:171 Sig:363
2015-12-24 11:43:15 UpdateTip: new best=0000000000000000028f6fd8d01813f2d3e424872467e2037276133f7863f841 height=387424 log2_work=83.711081 tx=96543602 date=2015-12-09 03:17:33 progress=0.986500 cache=46.4MiB(10710tx)
2015-12-24 11:43:15 Acceptable block: ver:3 time:1449632322 size: 934399 Tx:2851 Sig:5708
2015-12-24 11:43:17 UpdateTip: new best=000000000000000004669741ed4dbfb226b1370d7b77436e7d048be9997ef0b3 height=387425 log2_work=83.711112 tx=96546453 date=2015-12-09 03:38:42 progress=0.986514 cache=50.1MiB(15199tx)
2015-12-24 11:43:17 Acceptable block: ver:4 time:1449632583 size: 837290 Tx:1141 Sig:9959
2015-12-24 11:43:25 UpdateTip: new best=00000000000000000cdc54824b2a8140a509081f0d57607ff7a4a46f8c95cebb height=387426 log2_work=83.711143 tx=96547594 date=2015-12-09 03:43:03 progress=0.986516 cache=2.0MiB(0tx)
2015-12-24 11:43:25 Acceptable block: ver:3 time:1449633095 size: 739468 Tx:1494 Sig:4495
2015-12-24 11:43:27 UpdateTip: new best=00000000000000000292f27e3eb549dac78b7a7b0f7103fe97b1092ec699cca7 height=387427 log2_work=83.711174 tx=96549088 date=2015-12-09 03:51:35 progress=0.986522 cache=12.1MiB(4020tx)
2015-12-24 11:43:27 Acceptable block: ver:4 time:1449634499 size: 934381 Tx:2680 Sig:6389
2015-12-24 11:43:29 UpdateTip: new best=000000000000000007b78d2f781c7892e7fbeb76f19a518e5501fef90d991724 height=387428 log2_work=83.711205 tx=96551768 date=2015-12-09 04:14:59 progress=0.986536 cache=19.3MiB(8995tx)
2015-12-24 11:43:29 Acceptable block: ver:4 time:1449635476 size: 999566 Tx:2444 Sig:19533
2015-12-24 11:43:30 Pre-allocating up to position 0x400000 in rev00390.dat
2015-12-24 11:43:30 UpdateTip: new best=00000000000000000697820c1e1f42cfbceb2423e4fc369c5c8efbc59df9f5af height=387429 log2_work=83.711236 tx=96554212 date=2015-12-09 04:31:16 progress=0.986547 cache=23.2MiB(12575tx)
2015-12-24 11:43:30 Acceptable block: ver:4 time:1449635846 size: 999969 Tx:1583 Sig:4451
2015-12-24 11:43:32 UpdateTip: new best=00000000000000000d93e8333e19f4e45ea9f9731287f31e576e68ad3f8d8789 height=387430 log2_work=83.711267 tx=96555795 date=2015-12-09 04:37:26 progress=0.986551 cache=42.2MiB(16216tx)
2015-12-24 11:43:32 Acceptable block: ver:3 time:1449636064 size: 672524 Tx:747 Sig:2432
2015-12-24 11:43:34 UpdateTip: new best=00000000000000000cdd4fea3de9907a9d0941f0acdac2b6bae01782c5f0b286 height=387431 log2_work=83.711298 tx=96556542 date=2015-12-09 04:41:04 progress=0.986553 cache=55.9MiB(18206tx)
2015-12-24 11:43:34 Acceptable block: ver:4 time:1449637134 size: 900148 Tx:1884 Sig:6174
2015-12-24 11:43:36 Corruption: block checksum mismatch
2015-12-24 11:43:36 *** System error while flushing: Database corrupted

After pressing okay I get the message that Bitcoin Unlimited is shutting down.

I have some screen dumps in a Writer document but they are bigger than 100K. Not allowed to upload.
 

freetrader

Moderator
Staff member
Dec 16, 2015
2,806
6,088
@steffen, it looks like this issue, which is not specific to Bitcoin Unlimited:

https://github.com/bitcoin/bitcoin/issues/6528

I would run a thorough disk and memory check on the machine to exclude hardware errors, and try to re-index as some people in that thread have found it to work eventually.

I think the command would be: bitcoin-qt -reindex -par=1
 
Last edited:
  • Like
Reactions: steffen

steffen

Active Member
Nov 22, 2015
118
163
Thank you. I think I have worked around it. Reboot. Restart Bitcoin Unlimited. Now only 8 days behind.
 

steffen

Active Member
Nov 22, 2015
118
163
@theZerg Another harmless bug found. Go to Settings | Options | Main. The top option is labelled "Start Bitcoin Core on system login".
 

steffen

Active Member
Nov 22, 2015
118
163
I found this in another thread:

There now seem to be 22 nodes but I couldn't see my own Bitcoin Unlimited listed.

I used the tool near the bottom of the of the page to check if my Bitcoin client was currently accepting incoming connections from other nodes. Result:

188.183.147.187:8333 is unreachable.

My pc is behind a Netgear box from my ISP. I have tried setting up some port forwarding (and later something called port triggering) but that doesn't change anything. Either that is not working or I need to do something else to receive incoming connections. Any ideas?
 

Members online