2021-01-13 16:00:32 +02:00
{% include disclaimer.html translated="no" translationOutdated="no" %}
Simplify versioning system for user guides
This new approach doesn't require version numbers and make easier for contributors to understand the status
of the document. There are only 3 states:
- Outdated: The page is outdated and might not work as expected
- Untranslated: The page needs to be translated
- Translation outdated: The page is translated, but the original (English) document has been updated
To mark a guide as outdated, we change the boolean of the front matter entry 'outdated' in /resources/user-guides/GUIDE.
If 'False', the guide is updated. If 'True' all versions of the guide (English included) will show a warning at the bottom
of the page.
The other 2 states are related to the status of the translated pages and we control them from the language-specific
user guides: /_i18n/LANG/resources/user-guides/GUIDE. At the top of the page a snippet will include 2 parameters:
- translated: "yes" if the page is translated, "no" if it's not.
- translationOutdated: "yes" if the translation is outdated, "no" if it's not
This new system aims to be simpler than the precedent, avoiding to compare versioning numbers and using a higher level
system instead (yes, no, True, False). I also removed the middle way status 'only minor changes', because if there are
only minor changes that don't affect the usability of the guide, we don't need to point it out.
The old system was complex and people didn't use it. These changes will hopefully make things easier for translators and
other contributors.
2020-05-03 16:38:01 +03:00
2021-01-13 16:00:32 +02:00
### Purpose and Warning
2018-02-26 18:22:26 +02:00
2021-01-13 16:00:32 +02:00
Most people don't need this. To use Monero, just start the software and it will synchronize itself with the peer-to-peer network. Normally, this is much faster than downloading and importing the blockchain as detailed in this guide. This is because you'll be downloading from many peers instead of just a single server, and the Monero @daemon will verify each block as it's received, instead of verifying separately after downloading.
2018-02-26 18:22:26 +02:00
2021-01-13 16:00:32 +02:00
This option is mostly useful for development, or possibly if some unusual problem is preventing you from syncing the normal way.
2018-02-26 18:22:26 +02:00
2021-01-13 16:00:32 +02:00
**Never** use the dangerous unverified import option, it is strictly for experts only. Especially, don't use it with any blockchain you download from the Internet, including the official site. It is only safe to use if a) you are importing a file that you exported locally, yourself *and* b) you are absolutely sure it was already fully and properly verified before exporting.
2018-02-26 18:22:26 +02:00
2021-01-13 16:00:32 +02:00
### Step 1
2018-02-26 18:22:26 +02:00
2021-01-13 16:00:32 +02:00
Download the Current bootstrap from https://downloads.getmonero.org/blockchain.raw; you can skip this step if you are importing the blockchain from another source.
2018-02-26 18:22:26 +02:00
2021-01-13 16:00:32 +02:00
### Step 2
2018-02-26 18:22:26 +02:00
2021-01-13 16:00:32 +02:00
Find the path where the Monero software is installed. For example mine is:
2018-02-26 18:22:26 +02:00
2021-01-13 16:00:32 +02:00
`D:\monero-gui-0.10.3.1`
2018-02-26 18:22:26 +02:00
2021-01-13 16:00:32 +02:00
Your path may be different depending on where you decided to install the Monero software, and what version of the software you have.
2018-02-26 18:22:26 +02:00
2021-01-13 16:00:32 +02:00
### Step 3
2018-02-26 18:22:26 +02:00
2021-01-13 16:00:32 +02:00
Find the path of your downloaded blockchain for example mine was:
2018-02-26 18:22:26 +02:00
2021-01-13 16:00:32 +02:00
`C:\Users\KeeJef\Downloads\blockchain.raw`
2018-02-26 18:22:26 +02:00
2021-01-13 16:00:32 +02:00
Yours might be different depending on where you chose to save the downloaded blockchain.
2018-02-26 18:22:26 +02:00
2021-01-13 16:00:32 +02:00
### Step 4
2018-02-26 18:22:26 +02:00
2021-01-13 16:00:32 +02:00
Open a Command Prompt window. You can do this by pressing the Windows key + R, and then typing in the popup box `CMD` and pressing Enter.
2018-02-26 18:22:26 +02:00
2021-01-13 16:00:32 +02:00
### Step 5
Now you need to navigate using the CMD window to the path of your Monero software. You can do this by typing:
2018-02-26 18:22:26 +02:00
2021-01-13 16:00:32 +02:00
`cd C:\YOUR\MONERO\PATH\HERE`
2018-02-26 18:22:26 +02:00
2021-01-13 16:00:32 +02:00
It should look something like:
2018-02-26 18:22:26 +02:00
2021-01-13 16:00:32 +02:00
`cd D:\monero-gui-0.10.3.1`
2018-02-26 18:22:26 +02:00
2021-01-13 16:00:32 +02:00
If your Monero software is on another drive you can use `DriveLetter:` for example if your Monero software was on your D drive then before using the cd command you would do `D:`
2018-02-26 18:22:26 +02:00
2021-01-13 16:00:32 +02:00
### Step 6
2018-02-26 18:22:26 +02:00
2021-01-13 16:00:32 +02:00
Now type in your command prompt window:
2018-02-26 18:22:26 +02:00
2021-01-13 16:00:32 +02:00
`monero-blockchain-import --input-file C:\YOUR\BLOCKCHAIN\FILE\PATH\HERE`
2018-02-26 18:22:26 +02:00
2021-01-13 16:00:32 +02:00
For example I would type :
2018-02-26 18:22:26 +02:00
2021-01-13 16:00:32 +02:00
`monero-blockchain-import --input-file C:\Users\KeeJef\Downloads\blockchain.raw`
2018-02-26 18:22:26 +02:00
2021-01-13 16:00:32 +02:00
### Step 7
2018-02-26 18:22:26 +02:00
2021-01-13 16:00:32 +02:00
After the the blockchain has finished syncing up you can open your Monero wallet normally. Your downloaded blockchain.raw can be deleted.
