You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/docs/en/resources/archive/download-guide.mdx
+35Lines changed: 35 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -16,6 +16,17 @@ Before downloading, ensure you have sufficient:
16
16
17
17
## Download methods
18
18
19
+
:::callout
20
+
type: warn
21
+
### Archive Format Update: .tar.gz → .tar.zst
22
+
We are transitioning all Hiro archive downloads from gzip (.tar.gz) to the more efficient Zstandard (.tar.zst) format. Going forward, newly published archives will use the .zst extension. Older backups will continue to be available in .tar.gz.
23
+
24
+
**What this means for you:**
25
+
- Update any scripts or automation to download `*.tar.zst` instead of `*.tar.gz`.
Use `curl` with automatic retries for robust downloads. The `--continue-at -` flag resumes partial downloads, while `--output` specifies the filename:
46
57
58
+
:::callout
59
+
### Archive format update
60
+
This example uses `.tar.zst` for the new format. For all new backups, use `.zst`. For older backups, replace `.zst` with `.gz` and use `--output file.tar.gz`.
@@ -116,11 +138,24 @@ SHA256 checksum files are available for **all archives** to verify download inte
116
138
```
117
139
118
140
2.**Verify the download:**
141
+
142
+
:::callout
143
+
### Legacy checksum
144
+
Checksum verification for `.tar.gz` is provided for users downloading older backups. Use the `.zst` checksum example for all current and future archives.
3.**Extract the archive (requires zstd-tool to be installed):**
152
+
153
+
:::callout
154
+
type: tip
155
+
### Using older backups?
156
+
If you are working with a legacy `.tar.gz` archive, use the extraction command below. All new archives are distributed as `.tar.zst`, which requires zstd support (`tar -I zstd`).
157
+
:::
158
+
124
159
```terminal
125
160
$ tar -I zstd -xvf mainnet-stacks-blockchain-latest.tar.zst
0 commit comments