mirror of
https://github.com/seigler/dash-docs
synced 2025-07-27 09:46:12 +00:00
Full Node Guide: Add Windows 8/8.1 Instructions
Thanks to Paul Georgiou for instructions and screenshots! Closes #825, Closes #763
This commit is contained in:
parent
5340cb36de
commit
6917c1ecbd
3 changed files with 198 additions and 7 deletions
205
en/full-node.md
205
en/full-node.md
|
@ -643,14 +643,203 @@ If you're a expert system administrator and want to use an init script instead,
|
||||||
|
|
||||||
## Windows Instructions
|
## Windows Instructions
|
||||||
|
|
||||||
### Windows 8.1
|
### Windows 8.x
|
||||||
|
|
||||||
If you can provide instructions and screenshots for running the latest
|
*Instructions for Bitcoin Core 0.10.0 on Windows 8 and 8.1.*
|
||||||
version of Bitcoin Core on Windows 8.1, please [open an
|
|
||||||
issue](https://github.com/bitcoin/bitcoin.org/issues/new) and we'll tell
|
Go to the [Bitcoin Core download page](/en/download) and verify you have
|
||||||
you what we need.
|
made a secure connection to the server.
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
Click the large blue *Download Bitcoin Core* button to download the
|
||||||
|
Bitcoin Core installer to your desktop.
|
||||||
|
|
||||||
|
{{verifyReleaseSignatures}}
|
||||||
|
|
||||||
|
After downloading the file to your desktop or your Downloads folder
|
||||||
|
(`C:\Users\<YOUR USER NAME>\Downloads`), run it by double-clicking
|
||||||
|
its icon. Windows will ask you to confirm that you want to run it:
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
The Bitcoin installer will start. It's a typical Windows installer, and
|
||||||
|
it will guide you through the decisions you need to make about where to
|
||||||
|
install Bitcoin Core.
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
<div class="box" markdown="1">
|
||||||
|
*To continue, choose one of the following options*
|
||||||
|
|
||||||
|
1. If you want to use the Bitcoin Core Graphical User Interface (GUI),
|
||||||
|
proceed to the [Bitcoin Core GUI](#win8-gui) section below.
|
||||||
|
|
||||||
|
2. If you want to use the Bitcoin Core daemon (bitcoind), which is
|
||||||
|
useful for programmers and advanced users, proceed to the [Bitcoin
|
||||||
|
Core Daemon](#win8-daemon) section below.
|
||||||
|
|
||||||
|
3. To want to use both the GUI and the daemon, read both the [GUI
|
||||||
|
instructions](#win8-gui) and the [daemon
|
||||||
|
instructions](#win8-daemon). Note that you can't run both the GUI
|
||||||
|
and the daemon at the same time using the same configuration
|
||||||
|
directory.
|
||||||
|
|
||||||
|
</div>
|
||||||
|
|
||||||
|
#### Bitcoin Core GUI {#win8-gui}
|
||||||
|
{:.no_toc}
|
||||||
|
|
||||||
|
Press the Windows key (`⊞ Win`) and start typing "bitcoin". When the
|
||||||
|
Bitcoin Core icon appears (as shown below), click on it.
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
You will be prompted to choose a directory to store the Bitcoin block
|
||||||
|
chain and your wallet. Unless you have a separate partition or drive
|
||||||
|
you want to use, click Ok to use the default.
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
Your firewall may block Bitcoin Core from making outbound connections.
|
||||||
|
It's safe to allow Bitcoin Core to use all networks. (Note: you will
|
||||||
|
still need to configure inbound connections as described later in the
|
||||||
|
[Network Configuration](#network-configuration) section.)
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
Bitcoin Core GUI 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 by closing it; it will
|
||||||
|
resume from the point where it stopped the next time you start it.
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
After download is complete, you may use Bitcoin Core as your wallet or
|
||||||
|
you can just let it run to help support the Bitcoin network.
|
||||||
|
|
||||||
|
<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 GUI to start at login.
|
||||||
|
|
||||||
|
While running Bitcoin Core GUI, open the Settings menu and choose
|
||||||
|
Options. On the Main tab, click *Start Bitcoin on system login*. Click
|
||||||
|
the Ok button to save the new settings.
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
The next time you login to your desktop, Bitcoin Core GUI will be
|
||||||
|
automatically started minimized in the task bar.
|
||||||
|
|
||||||
|
{{windows_shutdown_warning}}
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{{installFinished}}
|
||||||
|
|
||||||
|
|
||||||
|
#### Bitcoin Core Daemon {#win8-daemon}
|
||||||
|
{:.no_toc}
|
||||||
|
|
||||||
|
To start Bitcoin Core daemon, first open a command window: press the
|
||||||
|
Windows key (`⊞ Win`) and type "cmd". Choose the option labeled
|
||||||
|
"Command Prompt".
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
If you installed Bitcoin Core into the default directory, type the
|
||||||
|
following at the command prompt:
|
||||||
|
|
||||||
|
C:\Program Files\Bitcoin\daemon\bitcoind -daemon
|
||||||
|
|
||||||
|
It will display an error message similar to the one below:
|
||||||
|
|
||||||
|
Error: To use the bitcoind or the "-server" option to bitcoin-qt,
|
||||||
|
you must set a rpcpassword in the configuration file:
|
||||||
|
C:\Users\Example\AppData\Roaming\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
|
||||||
|
|
||||||
|
Pay attention to these particular lines:
|
||||||
|
|
||||||
|
C:\Users\<YOUR USER NAME>\AppData\Roaming\Bitcoin\bitcoin.conf
|
||||||
|
[...]
|
||||||
|
rpcuser=bitcoinrpc
|
||||||
|
rpcpassword=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
|
||||||
|
|
||||||
|
The first line will actually have your username. The later two lines
|
||||||
|
will include a randomly-generated password that you will need
|
||||||
|
to copy and paste. (Do not use XXXXXXX.)
|
||||||
|
|
||||||
|
Leave the command prompt window open and start File Explorer.
|
||||||
|
In File Explorer, open the directory indicated in the message
|
||||||
|
(`C:\Users\<YOUR USER NAME>\AppData\Roaming\Bitcoin`), right-click on
|
||||||
|
the File Explorer window and choose New → Text file. Name the file
|
||||||
|
`bitcoin.conf` and then right-click on it and choose to open it in
|
||||||
|
Notepad or your preferred text editor.
|
||||||
|
|
||||||
|
In the command prompt, copy the `rpcuser` and `rpcpassword` lines.
|
||||||
|
Paste them into the text editor and then save and close the file.
|
||||||
|
By default, you shouldn't need to change the file permissions.
|
||||||
|
|
||||||
|
Return to the command prompt and press the Up arrow key to get the
|
||||||
|
previous command (ending in `bitcoind -daemon`) and run it again.
|
||||||
|
Bitcoin Core daemon should start and 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). If you installed Bitcoin
|
||||||
|
Core into the default location, type the following at the command
|
||||||
|
prompt to see whether it works:
|
||||||
|
|
||||||
|
C:\Program Files\Bitcoin\daemon\bitcoin-cli getblockchaininfo
|
||||||
|
|
||||||
|
{{start_up_and_recommended_commands}}
|
||||||
|
|
||||||
|
For example, to safely stop your node, run the following command:
|
||||||
|
|
||||||
|
C:\Program Files\Bitcoin\daemon\bitcoin-cli stop
|
||||||
|
|
||||||
|
{{complete_list_of_commands_and_ibd}}
|
||||||
|
|
||||||
|
<div class="box" markdown="1">
|
||||||
|
*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 when you login to your computer.
|
||||||
|
|
||||||
|
Start File Explorer and go to,
|
||||||
|
|
||||||
|
C:\ProgramData\Microsoft\Windows\Start Menu\Programs\StartUp
|
||||||
|
|
||||||
|
Right-click on the File Explorer window and choose New → Text file.
|
||||||
|
Name the file `start_bitcoind.bat`. Then right-click on it and choose
|
||||||
|
Open in Notepad (or whatever editor you prefer). Copy and paste the
|
||||||
|
following line into the file.
|
||||||
|
|
||||||
|
C:\Program Files\Bitcoin\daemon\bitcoind -daemon
|
||||||
|
|
||||||
|
(If you installed Bitcoin Core in a non-default directory, use that
|
||||||
|
directory path instead.)
|
||||||
|
|
||||||
|
Save the file. The next time you login to your computer, Bitcoin Core
|
||||||
|
daemon will be automatically started.
|
||||||
|
|
||||||
|
{{windows_shutdown_warning}}
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{{installFinished}}
|
||||||
|
|
||||||
### Windows 7
|
### Windows 7
|
||||||
|
|
||||||
|
@ -666,7 +855,8 @@ Bitcoin Core installer to your desktop.
|
||||||
|
|
||||||
{{verifyReleaseSignatures}}
|
{{verifyReleaseSignatures}}
|
||||||
|
|
||||||
After downloading the file to your desktop, run it by double-clicking
|
After downloading the file to your desktop or your Downloads folder
|
||||||
|
(`C:\Users\<YOUR USER NAME>\Downloads`), run it by double-clicking
|
||||||
its icon. Windows will ask you to confirm that you want to run it:
|
its icon. Windows will ask you to confirm that you want to run it:
|
||||||
|
|
||||||

|

|
||||||
|
@ -756,7 +946,8 @@ automatically started minimized in the task bar.
|
||||||
If you can provide instructions and screenshots for running the latest
|
If you can provide instructions and screenshots for running the latest
|
||||||
version of Bitcoin Core daemon on Windows 7, please [open an
|
version of Bitcoin Core daemon on Windows 7, please [open an
|
||||||
issue](https://github.com/bitcoin/bitcoin.org/issues/new) and we'll tell
|
issue](https://github.com/bitcoin/bitcoin.org/issues/new) and we'll tell
|
||||||
you what we need.
|
you what we need. The instructions for [Windows
|
||||||
|
8.x](#win8-daemon) may already provide all the necessary information.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
BIN
img/full-node/en-win8-running-cmd.png
Normal file
BIN
img/full-node/en-win8-running-cmd.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 8 KiB |
BIN
img/full-node/en-win8-start-bitcoin-core.png
Normal file
BIN
img/full-node/en-win8-start-bitcoin-core.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 7.5 KiB |
Loading…
Add table
Add a link
Reference in a new issue