diff --git a/en/full-node.md b/en/full-node.md index 8405accd6d..0ce0b982c2 100644 --- a/en/full-node.md +++ b/en/full-node.md @@ -165,15 +165,19 @@ have an easy-to-use node. The following instructions describe installing Bitcoin Core on Linux systems. -### Ubuntu 14.10 Desktop +### Ubuntu 14.10 *Instructions for Bitcoin Core 0.10.0.* -Click the Ubuntu swirl icon to start the Dash and type "term" into the +If you use Ubuntu Desktop, click the Ubuntu swirl icon to start the Dash and type "term" into the input box. Choose any one of the terminals listed: ![Dash term](/img/full-node/en-dash-term.png) +Alternatively, access a console or terminal emulator using another +method, such as SSH on Ubuntu Server or a terminal launcher in an +alternative desktop environment. + Type the following line to add the Bitcoin Personal Package Archive (PPA) to your system: @@ -284,160 +288,10 @@ automatically started in as an icon in the tray. #### Bicoin Core Daemon {#ubuntu-daemon} {:.no_toc} -Before using the Bitcoin Core daemon, `bitcoind`, you need to create its -configuration file with a user name and password. First create the -`.bitcoin` directory, create (touch) the file, and set the file's -permissions so that only your user account can read it. From the -terminal, type: - - mkdir ~/.bitcoin - touch ~/.bitcoin/bitcoin.conf - chmod 600 ~/.bitcoin/bitcoin.conf - -Then you can run the command `bitcoind`. It will print output similar -to this: - - bitcoind - Error: To use the "-server" option, you must set a rpcpassword in the configuration file: - /home/bitcoinorg/.bitcoin/bitcoin.conf - It is recommended you use the following random password: - rpcuser=bitcoinrpc - rpcpassword=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - (you do not need to remember this password) - The username and password MUST NOT be the same. - If the file does not exist, create it with owner-readable-only file permissions. - It is also recommended to set alertnotify so you are notified of problems; - for example: alertnotify=echo %s | mail -s "Bitcoin Alert" admin@foo.com - -The "rpcpassword" displayed will be unique for your system. You can -copy the rpcuser and rpcpassword lines into your configuration file -using the following commands. Note that in most Ubuntu terminals, you need -to press Ctrl-Shift-C to copy and Ctrl-Shift-V to paste because Ctrl-C -and Ctrl-V have different meanings in a Unix-style terminal. - - echo rpcuser=bitcoinrpc >> ~/.bitcoin/bitcoin.conf - echo rpcpassword=XXXXXX >> ~/.bitcoin/bitcoin.conf - -(**Warning:** Don't use XXXXXX as your RPC password. Copy the -rpcpassword displayed by bitcoind for your system.) - -Now you can start Bitcoin Core daemon for real. Type the following -command: - - bitcoind -daemon - -It will print a message that Bitcoin Core is starting. To interact with -Bitcoin Core daemon, you will use the command `bitcoin-cli` (Bitcoin -command line interface). Note: it may take up to several minutes for -Bitcoin Core to start, during which it will display the following -message whenever you use `bitcoin-cli`: - - error: {"code":-28,"message":"Verifying blocks..."} - -After it starts, you may find the following commands useful for basic -interaction with your node: -[`getblockchaininfo`](/en/developer-reference#getblockchaininfo), -[`getnetworkinfo`](/en/developer-reference#getnetworkinfo), -[`getnettotals`](/en/developer-reference#getnettotals), -[`getwalletinfo`](/en/developer-reference#getwalletinfo), -[`stop`](/en/developer-reference#stop), and [`help`](/en/developer-reference#help). -For example, to safely stop your node, run the following command: - - bitcoin-cli stop - -A complete list of commands is available in the [Bitcoin.org developer -reference](/en/developer-reference#rpc-quick-reference). - -When Bitcoin Core daemon first starts, it will begin to download the -block chain. This step will take at least several hours, and it may -take a day or more on a slow Internet connection or with a slow -computer. During the download, Bitcoin Core will use a significant part -of your connection bandwidth. You can stop Bitcoin Core at any time using -the `stop` command; it will resume from the point where it stopped the next -time you start it. - -
-*Optional: Start Your Node At Boot* - -Starting your node automatically each time your computer boots makes it -easy for you to contribute to the network. The easiest way to do this -is to start Bitcoin Core daemon from your crontab. To edit your -crontab, run the following command: - - crontab -e - -Scroll to the bottom of the file displayed and add the following line: - - @reboot bitcoind -daemon - -Save the file and exit; the updated crontab file will be installed for -you. Now Bitcoin Core daemon will be automatically started each time -your reboot your computer. - -If you're an Ubuntu expert and want to use an init script instead, see -[this Upstart -script](https://github.com/bitcoin/bitcoin/tree/0.10/contrib/init/bitcoind.conf). -
- -{{installFinished}} - -### Ubuntu 14.04 LTS Server - -*Instructions for Bitcoin Core 0.10.0.* - -Log into your Ubuntu server using SSH or another method that gives you -command line access. These first steps need to be performed as an -administrative user with sudo access. - -Type the following line to add the Bitcoin Personal Package Archive -(PPA) to your system: - - sudo apt-add-repository ppa:bitcoin/bitcoin - -You will be prompted for your user password. Provide it to continue. -Afterwards, the following text will be displayed: - - Stable Channel of bitcoin-qt and bitcoind for Ubuntu, and their dependencies - More info: https://launchpad.net/~bitcoin/+archive/ubuntu/bitcoin - Press [ENTER] to continue or ctrl-c to cancel adding it - -Press enter to continue. The following text (with some variations) will -be displayed and you will be returned to the command line prompt: - - gpg: keyring `/tmp/tmpixuqu73x/secring.gpg' created - gpg: keyring `/tmp/tmpixuqu73x/pubring.gpg' created - gpg: requesting key 8842CE5E from hkp server keyserver.ubuntu.com - gpg: /tmp/tmpixuqu73x/trustdb.gpg: trustdb created - gpg: key 8842CE5E: public key "Launchpad PPA for Bitcoin" imported - gpg: no ultimately trusted keys found - gpg: Total number processed: 1 - gpg: imported: 1 (RSA: 1) - OK - -Type the following line to get the most recent list of packages: - - sudo apt-get update - -A large number of lines will be displayed as different update files are -downloaded. This step may take several minutes on a slow Internet -connection. - -To install the Bitcoin Core daemon (bitcoind), which is useful for -programmers and advanced users, type the following line and proceed to -the [Bitcoin Core Daemon](#ubuntu-daemon) section below: - - sudo apt-get install bitcoind - -After choosing what packages to install, you will be asked whether you -want to proceed. Press enter to continue. - -#### Bicoin Core Daemon {#ubuntu-server-daemon} -{:.no_toc} - If you're logged in as an administrative user with sudo access, you may log out. The steps in this section should be performed as the user you -want to run Bitcoin Core. (This can be a locked account used only by -Bitcoin Core.) +want to run Bitcoin Core. (If you're an expert administrator, you can +make this a locked account used only by Bitcoin Core.) Before using the Bitcoin Core daemon, `bitcoind`, you need to create its configuration file with a user name and password. First create the @@ -531,12 +385,11 @@ your reboot your computer. If you're an Ubuntu expert and want to use an init script instead, see [this Upstart -script](https://github.com/bitcoin/bitcoin/blob/2d782ab2ce30bf106e34cd3288c9082ac04022f9/contrib/init/bitcoind.conf). +script](https://github.com/bitcoin/bitcoin/tree/0.10/contrib/init/bitcoind.conf). {{installFinished}} - ### Other Linux Distributions *Instructions for Bitcoin Core 0.10.0.*