Skip to content

docs: update core install verification #335

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 5 commits into from
Jan 18, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file modified docs/user/wallets/dashcore/img/linux/setup-linux-gpg.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
21 changes: 13 additions & 8 deletions docs/user/wallets/dashcore/installation-linux.rst
Original file line number Diff line number Diff line change
Expand Up @@ -49,18 +49,15 @@ To download the detached signature, click the **Signature** button on the
wallet download page and save it to the same folder as the downloaded
binary.

All releases of Dash are signed using GPG with one of the following keys:
All releases of Dash since 0.16.0 are signed using GPG with the following key:

- Pasta (pasta) with the key ``5252 7BED ABE8 7984``, `verifiable here
on Keybase <https://keybase.io/pasta>`__ (releases 0.16.0+)
- Alexander Block (codablock) with the key ``63A9 6B40 6102 E091``, `verifiable
here on Keybase <https://keybase.io/codablock>`__ (releases prior to 0.16.0)
- Pasta (pasta) with the key ``5252 7BED ABE8 7984``, `verifiable on Keybase
<https://keybase.io/pasta>`__ (`download <https://keybase.io/pasta/pgp_keys.asc>`__)

Open a terminal, import the keys and verify the authenticity of your
Open a terminal, import the key and verify the authenticity of your
download as follows::

curl https://keybase.io/pasta/pgp_keys.asc | gpg --import
curl https://keybase.io/codablock/pgp_keys.asc | gpg --import
gpg --verify dashcore-20.0.4-x86_64-linux-gnu.tar.gz.asc

.. figure:: img/linux/setup-linux-gpg.png
Expand All @@ -71,6 +68,14 @@ download as follows::
If you see the message ``Good signature from ...`` then you have an
authentic copy of Dash Core for Linux.

.. note::

If you have your own key configured, you can eliminate warnings from the
verification output by signing the imported key before verifying::

gpg --quick-lsign-key "29590362EC878A81FD3C202B52527BEDABE87984"
gpg --verify dashcore-20.0.4-x86_64-linux-gnu.tar.gz.asc

Extracting Dash Core
----------------------

Expand All @@ -96,7 +101,7 @@ Start Dash Core from the terminal with the following command::

The first time the program is launched, you will be offered a choice of
where you want to store your blockchain and wallet data. Choose a
location with enough free space, as the blockchain can reach 30GB+ in
location with enough free space, as the blockchain can reach 45GB+ in
size. It is recommended to use the default data folder if possible.

.. figure:: img/linux/106329842.png
Expand Down
21 changes: 13 additions & 8 deletions docs/user/wallets/dashcore/installation-macos.rst
Original file line number Diff line number Diff line change
Expand Up @@ -40,17 +40,14 @@ button on the wallet download page and save it to the same folder as the
downloaded binary (which should be by default). You may also need to
download GPG, which you can do via https://gpgtools.org/.

All releases of Dash are signed using GPG with one of the following keys:
All releases of Dash since 0.16.0 are signed using GPG with the following key:

- Alexander Block (codablock) with the key ``63A9 6B40 6102 E091``,
`verifiable here on Keybase <https://keybase.io/codablock>`__
- Pasta (pasta) with the key ``5252 7BED ABE8 7984``, `verifiable here
on Keybase <https://keybase.io/pasta>`__
- Pasta (pasta) with the key ``5252 7BED ABE8 7984``, `verifiable on Keybase
<https://keybase.io/pasta>`__ (`download <https://keybase.io/pasta/pgp_keys.asc>`__)

Open a terminal, import the keys and verify the authenticity of your
download as follows::

curl https://keybase.io/codablock/pgp_keys.asc | gpg --import
curl https://keybase.io/pasta/pgp_keys.asc | gpg --import
gpg --verify dashcore-20.0.4-osx.dmg.asc

Expand All @@ -63,6 +60,14 @@ download as follows::
If you see the message ``Good signature from ...`` then you have an
authentic copy of Dash Core for macOS.

.. note::

If you have your own key configured, you can eliminate warnings from the
verification output by signing the imported key before verifying::

gpg --quick-lsign-key "29590362EC878A81FD3C202B52527BEDABE87984"
gpg --verify dashcore-20.0.4-x86_64-linux-gnu.tar.gz.asc

Installing Dash Core
--------------------

Expand Down Expand Up @@ -104,8 +109,8 @@ future by double-clicking it just as you can any registered app.
Unblocking macOS from running Dash Core

The first time the program is launched, you will be offered a choice of
where you want to store your blockchain and wallet data. Choose a
location with enough free space, as the blockchain can reach 30GB+ in
where you want to store your blockchain and wallet data. Choose a
location with enough free space, as the blockchain can reach 45GB+ in
size. It is recommended to use the default data folder if possible.

.. figure:: img/macos/112415002.png
Expand Down
20 changes: 9 additions & 11 deletions docs/user/wallets/dashcore/installation-windows.rst
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ Windows Installation Guide

This guide describes how to download, install and encrypt the Dash Core
wallet for Windows. The guide is written for Windows 10, but the steps
should be similar for Windows XP, Vista, 7 and 8.
should be similar for other versions of Windows.

Downloading the Dash Core wallet
--------------------------------
Expand Down Expand Up @@ -47,22 +47,20 @@ download the detached signature, click the **Installer Signature**
button on the wallet download page and save it to the same folder as the
downloaded binary.

All releases of Dash are signed using GPG with one of the following keys:
All releases of Dash since 0.16.0 are signed using GPG with the following key:

- Alexander Block (codablock) with the key ``63A9 6B40 6102 E091``,
`verifiable here on Keybase <https://keybase.io/codablock>`__ (`download <https://keybase.io/codablock/pgp_keys.asc>`__)
- Pasta (pasta) with the key ``5252 7BED ABE8 7984``, `verifiable here
on Keybase <https://keybase.io/pasta>`__ (`download <https://keybase.io/pasta/pgp_keys.asc>`__)
- Pasta (pasta) with the key ``5252 7BED ABE8 7984``, `verifiable on Keybase
<https://keybase.io/pasta>`__ (`download <https://keybase.io/pasta/pgp_keys.asc>`__)

Download the key files above. Install `Gpg4win <https://gpg4win.org/>`__
Download the key file above. Install `Gpg4win <https://gpg4win.org/>`__
if it is not already available on your computer. Once it is installed,
open the **Kleopatra** certificate manager and click **File -> Import**.
Import the key files and verify the Key-ID matches the ID above.
Import the key file and verify the Key-ID matches the ID above.

.. figure:: img/windows/setup-windows-kleopatra-import.png
:height: 250px

Importing codablock's GPG public key
Importing Pasta's GPG public key

Skip any requests to certify the certificate with your own key. Next,
click **Decrypt/Verify...** and select the detached signature file named
Expand All @@ -82,7 +80,7 @@ of Dash Core for Windows.
.. figure:: img/windows/setup-windows-kleopatra-verified.png
:height: 250px

The binary installer has been verified
Example of successful binary installer verification

Running the Dash Core installer
-------------------------------
Expand Down Expand Up @@ -145,7 +143,7 @@ it does not, click **Start > Dash Core > Dash Core** to start the
application. The first time the program is launched, you will be offered
a choice of where you want to store your blockchain and wallet data.
Choose a location with enough free space, as the blockchain can reach
30GB+ in size. It is recommended to use the default data folder
45GB+ in size. It is recommended to use the default data folder
if possible.

.. figure:: img/windows/106328945.png
Expand Down