aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorsuper3 <me@super3.org>2014-02-25 20:54:47 -0500
committersuper3 <me@super3.org>2014-04-12 02:33:58 -0400
commitb698417fc87a43adfefdeaa01c30f658cf2487cf (patch)
treea6cd1f9fa0bc6849a6ade78d95be555005b13ff9 /doc
parent6e7792003b5c520fcc81d223f07471d690594081 (diff)
downloadbitcoin-b698417fc87a43adfefdeaa01c30f658cf2487cf.tar.xz
Added Blockchain Bootstraping Tutorial
Per @laanwj request in #3724 Fixing Checkpoints Comment Fixed Image Paths Removed requirement. Update Torrent Links. Update Links 2 Link would not work. 2 Small Fixes Changed in to from @laanwj suggestion on safety
Diffstat (limited to 'doc')
-rw-r--r--doc/README.md2
-rw-r--r--doc/bootstrap.md65
-rw-r--r--doc/img/bootstrap1.pngbin0 -> 55028 bytes
-rw-r--r--doc/img/bootstrap2.pngbin0 -> 35195 bytes
-rw-r--r--doc/img/bootstrap3.pngbin0 -> 56598 bytes
-rw-r--r--doc/img/bootstrap4.pngbin0 -> 110060 bytes
-rw-r--r--doc/img/bootstrap5.pngbin0 -> 20825 bytes
7 files changed, 66 insertions, 1 deletions
diff --git a/doc/README.md b/doc/README.md
index c23d4a484e..dd76f28bac 100644
--- a/doc/README.md
+++ b/doc/README.md
@@ -6,7 +6,7 @@ Copyright (c) 2009-2013 Bitcoin Developers
Setup
---------------------
-[Bitcoin Core](http://bitcoin.org/en/download) is the original Bitcoin client and it builds the backbone of the network. However, it downloads and stores the entire history of Bitcoin transactions (which is currently several GBs); depending on the speed of your computer and network connection, the synchronization process can take anywhere from a few hours to a day or more. Thankfully you only have to do this once. If you would like the process to go faster you can [download the blockchain directly](https://bitcointalk.org/index.php?topic=145386.0).
+[Bitcoin Core](http://bitcoin.org/en/download) is the original Bitcoin client and it builds the backbone of the network. However, it downloads and stores the entire history of Bitcoin transactions (which is currently several GBs); depending on the speed of your computer and network connection, the synchronization process can take anywhere from a few hours to a day or more. Thankfully you only have to do this once. If you would like the process to go faster you can [download the blockchain directly](bootstrap.md).
Running
---------------------
diff --git a/doc/bootstrap.md b/doc/bootstrap.md
new file mode 100644
index 0000000000..fefd33831a
--- /dev/null
+++ b/doc/bootstrap.md
@@ -0,0 +1,65 @@
+### Bootstrap the Blockchain Synchronization
+
+Normally the Bitcoin client will download the transaction and network information, called the blockchain, from network by syncing with the other clients. This can be a process that can take multiple days as the [Bitcoin block chain](https://blockchain.info/charts/blocks-size) has grown to more than 15 gigabytes, and is growing almost a gigabyte every month. Luckily there is a safe and fast way to speed up this process. We’ll show you how to bootstrap your blockchain to bring your client up to speed in just a few simple steps.
+
+### Requirements
+
+A fresh install of the Bitcoin client software.
+
+### Download the blockchain via Bittorent
+
+Jeff Garzik, Bitcoin core developer, offers an [torrent file](https://bitcointalk.org/index.php?topic=145386.0) for bootstrapping purposes that is updated often. Bittorrent is a protocol that speeds up the downloading of large files by using the other clients in the network. Example free and safe open-source clients are [Deluge](http://deluge-torrent.org/) or [QBittorent](http://www.qbittorrent.org/). A guide to installing and configuring the torrent clients can be found [here](http://dev.deluge-torrent.org/wiki/UserGuide) for Deluge and [here](http://qbforums.shiki.hu/) for QBittorent. A further in-depth tutorial on Bittorent can be found [here](http://www.howtogeek.com/howto/31846/bittorrent-for-beginners-how-get-started-downloading-torrents/).
+
+With the client installed we’ll proceed to download the blockchain torrent file. Use the following magnet link:
+
+ magnet:?xt=urn:btih:2d4e6c1f96c5d5fb260dff92aea4e600227f1aea&dn=bootstrap.dat&tr=udp://tracker.openbittorrent.com:80&tr=udp://tracker.publicbt.com:80&tr=udp://tracker.ccc.de:80&tr=udp://tracker.istole.it:80
+
+ or go to [Jeff Garzik's topic](https://bitcointalk.org/index.php?topic=145386.0) for a signed magnet link. Alternately you can use the [.torrent file](http://sourceforge.net/projects/bitcoin/files/Bitcoin/blockchain/bootstrap.dat.torrent/download) found on Sourceforge.
+
+![Fig1](img/bootstrap1.png)
+
+The download page should look like this, with a countdown to the download. If it does not work click the direct download link.
+
+The torrent client installed will recognize the download of the torrent file. Save the bootstrap.dat file to a folder you use for downloads. The image below shows the torrent download in QBittorent, with current speed and ETA highlighted.
+
+![Fig2](img/bootstrap2.png)
+
+### Download the block chain directly from official repositories
+The Bittorent version, see above, of the block chain download is refreshed more often than the direct download available. If Bittorent is blocked on your network then you can use the direct download method. Be sure to only use official repositories as the link displayed below. This download will only update the client to March 2013.
+
+Click [here](http://sourceforge.net/projects/bitcoin/files/Bitcoin/blockchain/bitcoin_blockchain_170000.zip/download) to download or copy and paste the link below.
+
+ http://sourceforge.net/projects/bitcoin/files/Bitcoin/blockchain/bitcoin_blockchain_170000.zip/download
+
+The download page should look like this, with a countdown to the download. If it does not work directly click the download. Save the file to a folder you use for downloads.
+![Fig3](img/bootstrap3.png)
+
+### Importing the blockchain
+Exit the Bitcoin Client software if you have it running. Be sure not to have an actively used wallet in use. Now we are going to copy the download of the blockchain to the Bitcoin client data directory. You should run the client software at least once so it can generate the data directory. Copy the downloaded bootstrap.dat file into the Bitcoin data folder.
+
+**For Windows users:**
+Open explorer, and type into the address bar:
+
+ %APPDATA%\Bitcoin
+
+This will open up the data folder. It should look like the image below. Copy over the bootstrap.dat from your download folder to this directory.
+![Fig4](img/bootstrap4.png)
+
+**For OSX users:**
+Open Finder by pressing Press [shift] + [cmd] + [g] and enter:
+
+ ~/Library/Application Support/Bitcoin/
+
+**For Linux users:**
+The directory is hidden in your User folder. Go to:
+
+ ~/.bitcoin/
+
+### Importing the blockchain
+Now start the Bitcoin client software. It should show "Importing blocks from disk" like the image below.
+![Fig5](img/bootstrap5.png)
+Wait until the import finishes. The client will download the last days not covered by the import. Congratulations you have successfully imported the blockchain!
+
+### Is this safe?
+
+Yes, the above method is safe. The download contains only raw block chain data and the client verifies this on import. Do not download the blockchain from unofficial sources, especially if they provide `*.rev` and `*.sst` files. These files are not verified and can contain malicious edits.
diff --git a/doc/img/bootstrap1.png b/doc/img/bootstrap1.png
new file mode 100644
index 0000000000..075930791b
--- /dev/null
+++ b/doc/img/bootstrap1.png
Binary files differ
diff --git a/doc/img/bootstrap2.png b/doc/img/bootstrap2.png
new file mode 100644
index 0000000000..6461f81810
--- /dev/null
+++ b/doc/img/bootstrap2.png
Binary files differ
diff --git a/doc/img/bootstrap3.png b/doc/img/bootstrap3.png
new file mode 100644
index 0000000000..8a6754e3e0
--- /dev/null
+++ b/doc/img/bootstrap3.png
Binary files differ
diff --git a/doc/img/bootstrap4.png b/doc/img/bootstrap4.png
new file mode 100644
index 0000000000..ad69737922
--- /dev/null
+++ b/doc/img/bootstrap4.png
Binary files differ
diff --git a/doc/img/bootstrap5.png b/doc/img/bootstrap5.png
new file mode 100644
index 0000000000..d8d9baaf37
--- /dev/null
+++ b/doc/img/bootstrap5.png
Binary files differ