Update documentation: clarify blockchain header sync requirement

Corrected previous misinformation:
- LBRY SDK DOES require blockchain header sync (not full blocks)
- First run: 5-10 minutes to download ~1.7M headers
- Added troubleshooting entry for BlockHeightEvent messages
- Users now understand what the sync process looks like
- Provided commands to stop the daemon

This addresses user concerns about the invasive blockchain sync
and ensures users know what to expect on first run.
This commit is contained in:
thePR0M3TH3AN committed 2026-03-15 21:36:47 -04:00
1 parent e218b76f97
commit 3d902208f9
2 files changed
+57 -8

No files matched your search

+7 -1
View File
@@ -48,7 +48,13 @@ The setup script will:
- ✅ Set download limits
- ✅ Create launcher scripts
**Note:** The LBRY SDK is a light client - it connects to the network and downloads content **without** needing to sync the entire blockchain (unlike Bitcoin). It only downloads the content you request.
**Important:** The LBRY SDK (lbrynet) requires syncing blockchain **headers** (not full blocks) to function. On first run:
- Downloads ~1.7 million block headers (takes 5-10 minutes)
- Uses minimal storage (headers only, not full blockchain)
- Subsequent starts are instant
- This is required to verify content claims on the network
This is lighter than Bitcoin's full blockchain sync, but still necessary for the downloader to work.
### Manual Install