-
Notifications
You must be signed in to change notification settings - Fork 2
/
Copy pathlinuxbuilds.html
137 lines (103 loc) · 7.94 KB
/
linuxbuilds.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
<!DOCTYPE html>
<html class="no-js" lang="en">
<head>
<title>Bitcoin Classic</title>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description" content="Bitcoin Classic">
<link rel="shortcut icon" href="assets/img/favicon.ico" type="image/icon">
<link rel="icon" href="assets/img/favicon.ico" type="image/icon">
<link rel="stylesheet" href="assets/css/bitcoin-classic.css">
<script src="assets/js/jquery-3.1.1.min.js"></script>
</head>
<body>
<div id="container">
<header>
<div class="grid">
<div class="col-1-3">
<a href="/"><img src="assets/img/[email protected]" alt="Bitcoin Classic Logo"></a>
</div>
<div class="col-2-3">
<button id="openMenu" class="openMenu" name="Menu toggle">
<img src="assets/img/menu_open.png" alt="Open menu">
</button>
</div>
</div>
<nav>
<ul class="menu">
<li>
<a class="" href="#" title="Getting started">Getting Started</a>
<ul>
<li><a class="" href="/gettingstarted.html" title="Overview">Overview</a></li>
<li><a class="" href="/downloads/index.html" title="Downloads">Downloads</a></li>
<li><a class="" title="Linux builds">Linux builds</a></li>
</ul>
</li>
<li><a class="" href="/community.html" title="Get Involved">Get Involved</a></li>
<li><a class="" href="/news.html" title="News">News</a></li>
</ul>
</nav>
</header>
<div class="content">
<section>
<h1>Running Bitcoin Classic on Linux</h1>
<p>This page describes the ways to install and manage Classic on your Linux machine.</p>
<div class="toc">
<ol>
<li><a href="#distro">Pick an install method</>.</li>
<li><a href="#config">Configure your node</a>.</li>
<li><a href="#security">Plan and secure your setup</a>.</li>
<li><a href="#unstable">Running nightly builds</a>.</li>
</ol>
</div>
<p>Bitcoin Classic ships both a background application (called daemon in Linux) <code>bitcoind</code> and a graphical application <code>bitcoin-qt</code>, you will have to choose one to run.
The daemon version of Bitcoin Classic can run without graphics systems installed on the system and the only way to interact with it is to use the command line.</p>
<p>Bitcoin Classic packages are created such that the bitcoin-qt application has to be run in a desktop session by the local user and it will download the blockchain into that user's homedir. Be aware, this is currently an almost 120 GB download!</p>
<p>The bitcoind background application is shipped to allow you to run it as its own user and the blockchain is downloaded to the <code>/var/lib/bitcoin</code> directory.
<h2 id="distro">Pick an install method</h2>
<p>To integrate best with Linux, the Bitcoin Classic team has prepared several options based on which distribution of Linux you are running.</p>
<p>The <strong>Ubuntu</strong> family of distros are supported using ubuntu's <a href="https://launchpad.net/%7Ebitcoinclassic/+archive/ubuntu/bitcoinclassic/" target="_ext">launchpad.net</a>.</br>
Please see our HOWTO for more info:
<a href="howtos/ubuntu-install.html">howtos/ubuntu-install</a></p>
<p>Debian all-in-one download build, which you can find in <a href="/downloads/index.html">downloads</a>.</p>
<p>ON <strong>ArchLinux</strong> use <a href="https://aur.archlinux.org/packages/bitcoin-classic/" target="_ext">bitcoin-classic</a> for the GUI app. or for your server the <a href="https://aur.archlinux.org/packages/bitcoin-classic-daemon/" target="_ext">bitcoin-classic-daemon</a>.</br>
Read more about ArchLinux building on the <a href="https://wiki.archlinux.org/index.php/Arch_User_Repository" target="_ext">AUR wiki</a>.</p>
<h2 id="config">Configure your node</h2>
<p>Bitcoin reads a config file called <code>bitcoin.conf</code>. Old nodes stored that in the <code>~/.bitcoin</code> directory, newer store it in the XDG_DATA_HOME spec defined place. Typically <code>~/.local/share/Bitcoin</code>, or in <code>~/.local/share/BitcoinCash</code>.</br>
The server packages we provide store the config file in <code>/etc/bitcoin</code></p>
<p>It is worth noting that editing your config file requires a restart of the software to activate your changes. Unlike other versions of Bitcoin, typos will cause an error and the node will request you fix it before it starts.</p>
<p>You can read the <code>/usr/share/doc/bitcoin/examples/bitcoin.conf</code> for configuration details, or simply run <code>bitcoind --help</code> on the command-line.</p>
<h2 id="security">Plan and secure your setup</h2>
<p>Installing the package will auto create a 'bitcoin' user and group. Please make sure you don't already have those before installing, or your install will fail.</p>
<p>The default setup for your daemon is that it has some config files in <code>/etc/bitcoin/</code> and the blockchain is stored in <code>/var/lib/bitcoind/</code>.</p>
<p>Running the daemon with systemd will disable the wallet functionality, run it manually, as your own user, if you need a wallet.</p>
<p>In case your machine is multi-user you should consider that read permissions to the <code>/etc/bitcoin</code> dir will allow a user to communicate (including shutting it down) your bitcoin daemon process. Additionally there is a log file in your <code>/var/lib/bitcoind</code> directory that may contain sensitive information.</p>
<p>For those multi-user machines we recommend removing the word-readable bit and putting selected users in the bitcoin group.</p>
<p>In order to communicate with your <code>bitcoind</code> instance there is a command called <code>bitcoin-cli</code>. Simply run <code>bitcoin-cli help</code> to get a full overview of commands.</p>
<h2 id="unsable">Running nightly builds</h2>
<p>Bitcoin Classic has nightly builds from the development branch. You should not run this on production servers unless you know what you are doing!</p>
<p>For Ubuntu family of systems there is a <a href="https://launchpad.net/~bitcoinclassic/+archive/ubuntu/nightly">launchpad PPA</a>.</p>
<p>For ArchLinux family of systems there are two AUR packages.</br>
<a href="https://aur.archlinux.org/packages/bitcoin-classic-git/">bitcoin-classic-git</a> for all of Classic,</br>
<a href="https://aur.archlinux.org/packages/bitcoin-classic-daemon-git/">bitcoin-classic-daemon-git</a> for a headless build.</p>
<h2 id="fail">Something didn't work</h2>
<p><strong>Installation failed of the package.</strong></p>
<p>The most likely reason for this is that since version 1.2 Bitcoin Classic creates its own <code>bitcoin</code> user. If you have manually created a user on the machine with the same name, installation will fail.</br>
You should remove the user from your <code>/etc/passwd</code>, <code>/etc/group</code> and <code>/etc/shadow</code> files. Then you can install the package. After installation is complete you may want to <code>chown</code> old files to the new user.</p>
<p><strong>bitcoin-cli doesn't want to connect</strong></p>
<p>First please check that the daemon is running. You can use <code>systemctl status bitcoind</code> to check.</br>
If it is running and you still can't communicate with it, check if your <code>/etc/bincoind/.cookie</code> (hidden) file exists and is readable by the user running <code>bitcoin-cli</code>.</br>
Last, you should try passing this parameter <code>-conf=/etc/bitcoin/bitcoin.conf</code> to <code>bitcoin-cli</code>.</p>
</section>
</div>
<footer>
<div class="grid">
<div class="col-1-3"><img src="assets/img/btcfooter.png"/></div>
<div class="col-2-3"><span id="copyright">© 2016-2017 Bitcoin Classic</br>
Content licensed under the <a href="https://creativecommons.org/licenses/by-sa/3.0/">CC by-sa</a></span></div>
</div>
</footer>
</div>
</body>
<script src="assets/js/bitcoin-classic.js"></script>
</html>