doc/README

   1 Bitcoin 0.3.25 BETA
   2
   3 Copyright (c) 2009-2011 Bitcoin Developers
   4 Distributed under the MIT/X11 software license, see the accompanying
   5 file license.txt or http://www.opensource.org/licenses/mit-license.php.
   6 This product includes software developed by the OpenSSL Project for use in
   7 the OpenSSL Toolkit (http://www.openssl.org/).  This product includes
   8 cryptographic software written by Eric Young (eay@cryptsoft.com).
   9
  10
  11 Intro
  12 -----
  13 Bitcoin is a free open source peer-to-peer electronic cash system that is
  14 completely decentralized, without the need for a central server or trusted
  15 parties.  Users hold the crypto keys to their own money and transact directly
  16 with each other, with the help of a P2P network to check for double-spending.
  17
  18
  19 Setup
  20 -----
  21 Unpack the files into a directory and run:
  22  bin/32/bitcoin (GUI, 32-bit)
  23  bin/32/bitcoind (headless, 32-bit)
  24  bin/64/bitcoin (GUI, 64-bit)
  25  bin/64/bitcoind (headless, 64-bit)
  26
  27
  28 Wallet Encryption
  29 -----------------
  30 Bitcoin supports native wallet encryption so that people who steal your wallet
  31 file don't automatically get access to all of your Bitcoins.  In order to enable
  32 this feature, chose "Encrypt Wallet" from the Options menu.  You will be prompted
  33 to enter a passphrase, which will be used as the key to encrypt your wallet and
  34 will be needed every time you wish to send Bitcoins.  If you lose this passphrase,
  35 you will lose access to spend all of the bitcoins in your wallet, no one, not even
  36 the Bitcoin developers can recover your Bitcoins.  This means you are responsible
  37 for your own security, store your password in a secure location and do not forget
  38 it.
  39
  40 Remember that the encryption built into bitcoin only encrypts the actual keys
  41 which are required to send your bitcoins, not the full wallet.  This means that
  42 someone who steals your wallet file will be able to see all the addresses which
  43 belong to you, as well as the relevant transactions, you are only protected from
  44 someone spending your coins.
  45
  46 It is recommended that you backup your wallet file before you encrypt your wallet.
  47 To do this, close the Bitcoin client and copy the wallet.dat file from ~/.bitcoin/
  48 on Linux, /Users/(user name)/Application Support/Bitcoin/ on Mac OSX, and
  49 %APPDATA%/Bitcoin/ on Windows (that is /Users/(user name)/AppData/Roaming/Bitcoin on
  50 Windows Vista and 7 and /Documents and Settings/(user name)/Application Data/Bitcoin
  51 on Windows XP).  Once you have copied that file to a safe location, reopen the
  52 Bitcoin client and Encrypt your wallet.  If everything goes fine, delete the backup
  53 and enjoy your encrypted wallet.  Note that once you encrypt your wallet, you will
  54 never be able to go back to a version of the Bitcoin client older than 0.4.
  55
  56 Keep in mind that you are always responsible for you own security.  All it takes is a
  57 slightly more advanced wallet-stealing trojan which installs a keylogger to steal
  58 your wallet passphrase as you enter it in addition to your wallet file and you have
  59 lost all your Bitcoins.  Wallet encryption cannot keep you safe if you do not practice
  60 good security, such as running up-to-date antivirus software, only entering your
  61 wallet passphrase in the Bitcoin client and using the same passphrase only as your
  62 wallet passphrase.
  63
  64
  65 See the documentation at the bitcoin wiki:
  66   https://en.bitcoin.it/wiki/Main_Page
  67
  68 ... for help and more information.