Qortal Project

The future of blockchain platforms

User Tools

Site Tools


Qortal Project Wiki

Important Notices


Project Model



Trade Portal

Data Hosting

Voting System

AT System


Frequently Asked Questions (FAQ)

How-To Guides

Node Setup Guides

Third-Party Services


How To Bootstrap & Delete The DB

To synchronize your node faster, you can easily 'bootstrap'. The UI doesn't sync, it just shows what your Core is doing. The Core is what syncs. Bootstrapping is when you download a compressed archive of the block database. It will be much faster to get that all at once, than to sync one block at a time from peers.

Please note: for ALL operating system types you can stop the core, delete the db folder, then start the core and it’ll automatically begin the bootstrap process… OR you can use the methods below (totally your choice and achieves the same result).

When the bootstrap process begins, you’ll see the popup with several 0-100% processes being completed. This may take an average of 30-60 minutes depending on your internet speed. The bootstrap servers may also fail from time to time, in which it’ll retry to bootstrap. For those with slow internet speeds, you may have trouble with this bootstrapping process. Also keep in mind that once the popup goes away, your node is NOT 100% synced - it’ll need to finish syncing the remaining blocks as a new bootstrap is created every 12 hours - this means your node will need to sync the remaining blocks since the latest bootstrap. You can 1) hover over the core icon in the system tray to view the current block height of your core, or 2) open your UI and view the current block height. You can then compare that number with the actual block height on the chain by going to exqlorer.com to get an idea of how far off your node is to becoming 100% synced.

Mac, Linux & Raspberry Pi (QORTector)

  1. Close the UI if it is open
  2. Copy and paste in terminal to first stop the core, wait for the message "ended successfully":
    cd qortal && ./stop.sh
  3. Copy and paste in terminal to remove the database folder and start the core, which will recreate the db folder and begin the bootstrap process:
    rm -R db && ./start.sh
  4. Bootstrap will begin!


There are two ways you could go about this..

Option 1:

  1. Close the UI if it is open
  2. Stop the Core if it is running (select exit from the core icon in the system tray)
  3. Locate the 'qortal' app folder: C:\Users\YOUR USER NAME HERE\AppData\Local\Qortal
  4. Locate the 'db' folder
  5. Delete the db folder
  6. Start the Core
  7. Bootstrap will begin!

Option 2:

  1. Close the UI if it is open
  2. Stop the Core if it is running (select exit from the core icon in the system tray)
  3. Right click start button and click run
  4. Copy and paste the following into the run command
  1. Run it (push ENTER), and it will open the folder with the qortal db folder in it
  2. Delete the db folder then start the Qortal core
  3. Bootstrap will begin!

Manual Bootstrap

If there are issues when the Core attempts to automatically download or extract the bootstrap, it's possible to do this process manually instead. Download a bootstrap archive file from one of the following links, extract the archive, and place the "blockchain.*" files into a folder named "db" within the "qortal" folder.

Full archive options (5.6 GB):

how_to_bootstrap_delete_the_db.txt · Last modified: 05/22/2023 14:52 by quickmythril