Merge pulls #1046 and #1124

- 1046: added instructions for setting up bitcoind on OS X
- 1124: Alerts: drop banner for UPnP vulnerability
This commit is contained in:
David A. Harding 2015-11-02 14:22:37 -05:00
commit fbfac539fa
No known key found for this signature in database
GPG key ID: 4B29C30FF29EC4B7
2 changed files with 44 additions and 7 deletions

View file

@ -4,9 +4,9 @@
title: "Vulnerability in UPnP library used by Bitcoin Core" title: "Vulnerability in UPnP library used by Bitcoin Core"
shorturl: "upnp-vulnerability" shorturl: "upnp-vulnerability"
active: true active: false
banner: "WARNING: serious vulnerability in UPnP library used by Bitcoin Core (click here to read)" #banner: "WARNING: serious vulnerability in UPnP library used by Bitcoin Core (click here to read)"
bannerclass: "alert" #bannerclass: "alert"
--- ---
## Summary ## Summary

View file

@ -1090,10 +1090,47 @@ automatically started minimized in the task bar.
#### Bitcoin Core Daemon {#osx-daemon} #### Bitcoin Core Daemon {#osx-daemon}
{:.no_toc} {:.no_toc}
If you can provide instructions and screenshots for running the latest The Bitcoin Core daemon (bitcoind) is not included in the .dmg file you may have downloaded to install Bitcoin-QT. Bitcoind, along with its support binaries, is instead included in the OS X .tar.gz file listed on the official Bitcoin Core download page. To download this file using Terminal, execute the following command:
version of Bitcoin Core daemon on OS X Yosemite, please [open an
issue](https://github.com/bitcoin-dot-org/bitcoin.org/issues/new) and we'll tell curl -O https://bitcoin.org/bin/bitcoin-core-{{site.DOWNLOAD_VERSION}}/bitcoin-{{site.DOWNLOAD_VERSION}}-osx64.tar.gz
you what we need.
{{verifyReleaseSignatures}}
Extract bitcoind and its support binaries from the archive we just downloaded by running this command in Terminal:
tar -zxf bitcoin-{{site.DOWNLOAD_VERSION}}-osx64.tar.gz
Now we'll move the executables into your default path to make running and stopping bitcoind easier. To move the executables, run these commands (note that we have to use `sudo` to perform these commands since we are modifying directories owned by root):
sudo mkdir -p /usr/local/bin
sudo cp bitcoin-{{site.DOWNLOAD_VERSION}}/bin/bitcoin* /usr/local/bin/.
To clean up the directory we've been working in, run:
rm -rf bitcoin-{{site.DOWNLOAD_VERSION}}*
Before we can run bitcoind, we need to make sure that it has a place to store the blockchain and a config file that contains a username and password for the daemon. The commands below will set up your bitcoin directory and give bitcoind a default username and a random password (you do not need to remember the password for standard operation).
mkdir ~/Library/Application\ Support/Bitcoin
touch ~/Library/Application\ Support/Bitcoin/bitcoin.conf
chmod 600 ~/Library/Application\ Support/Bitcoin/bitcoin.conf
echo "rpcuser=bitcoinrpc" >> ~/Library/Application\ Support/Bitcoin/bitcoin.conf
echo "rpcpassword=$(cat /dev/urandom | env LC_CTYPE=C tr -dc a-zA-Z0-9 | head -c45)" >> ~/Library/Application\ Support/Bitcoin/bitcoin.conf
You should now be able to start up your full node by running `bitcoind -daemon` in any Terminal window. If you need to stop bitcoind for any reason, the command is `bitcoin-cli stop`
<div class="box" markdown="1">
*Optional: Start Your Node At Login*
Starting your node automatically each time you login to your computer makes it easy for you to contribute to the network. The easiest way to do this is to tell Bitcoin Core Daemon to start at login. In OS X, the way to start background programs at login is using a Launch Agent. Here is how to install a Launch Agent for Bitcoin Core daemon on your machine:
mkdir ~/Library/LaunchAgents
curl https://raw.githubusercontent.com/bitcoin/bitcoin/master/contrib/init/org.bitcoin.bitcoind.plist > ~/Library/LaunchAgents/org.bitcoin.bitcoind.plist
The next time you login to your desktop, Bitcoin Core daemon will be automatically started.
</div>
{{installFinished}}
## Network Configuration ## Network Configuration