Skip to content

Commit b5f0fcd

Browse files
Update system requirements. (#1837)
* Update system requirements. Signed-off-by: bgravenorst <[email protected]> * Remove stray quote. Signed-off-by: bgravenorst <[email protected]> * Update docs/public-networks/get-started/system-requirements.md Co-authored-by: Alexandra Carrillo <[email protected]> Signed-off-by: Byron Gravenorst <[email protected]> --------- Signed-off-by: bgravenorst <[email protected]> Signed-off-by: Byron Gravenorst <[email protected]> Co-authored-by: Alexandra Carrillo <[email protected]>
1 parent e913e1f commit b5f0fcd

File tree

1 file changed

+31
-12
lines changed

1 file changed

+31
-12
lines changed

docs/public-networks/get-started/system-requirements.md

Lines changed: 31 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -52,17 +52,17 @@ docker image, or install the OpenJ9 JDK using the following steps:
5252
```bash
5353
tar -xvf YOUR_J9_IMAGE.tar.gz
5454
```
55-
55+
5656
</TabItem>
5757
<TabItem value="Example" label="Example">
58-
59-
```bash
58+
59+
```bash
6060
tar -xvf ibm-semeru-certified-jdk_x64_linux_21.0.3.0.tar.gz
6161
```
6262

6363
</TabItem>
6464
</Tabs>
65-
65+
6666
3. Move the binaries to `bin` directory:
6767

6868
<Tabs>
@@ -71,7 +71,7 @@ docker image, or install the OpenJ9 JDK using the following steps:
7171
```bash
7272
sudo cp -r YOUR_IMAGE/ /usr/bin/
7373
```
74-
74+
7575
</TabItem>
7676
<TabItem value="Example" label="Example">
7777

@@ -81,7 +81,7 @@ docker image, or install the OpenJ9 JDK using the following steps:
8181

8282
</TabItem>
8383
</Tabs>
84-
84+
8585
4. Specify OpenJ9 for Java on your machine:
8686

8787
<Tabs>
@@ -91,25 +91,25 @@ docker image, or install the OpenJ9 JDK using the following steps:
9191
sudo update-alternatives --install "/usr/bin/java" "java" "/usr/bin/YOUR_IMAGE" 1
9292
sudo update-alternatives --config java (and choose OpenJ9)
9393
```
94-
94+
9595
</TabItem>
9696
<TabItem value="Example" label="Example">
9797

9898
```bash
9999
sudo update-alternatives --install "/usr/bin/java" "java" "/usr/bin/jdk-21.0.3+9/bin/java"
100100
```
101-
101+
102102
</TabItem>
103103
</Tabs>
104-
104+
105105
Change your `JAVA_HOME` to OpenJ9 (if using the JDK implementation), where `jdk-install-dir` is
106106
the installation location you specified:
107107

108108
<Tabs>
109109
<TabItem value="Command" label="Command" default>
110110

111111
```bash
112-
export JAVA_HOME=jdk-install-dir`
112+
export JAVA_HOME=jdk-install-dir
113113
```
114114

115115
</TabItem>
@@ -118,7 +118,7 @@ docker image, or install the OpenJ9 JDK using the following steps:
118118
```bash
119119
export JAVA_HOME=/usr/bin/jdk-21.0.3+9
120120
```
121-
121+
122122
</TabItem>
123123
</Tabs>
124124

@@ -130,7 +130,26 @@ JVM memory requirements are highest when syncing, but will reduce after the node
130130

131131
## Disk space
132132

133-
[Fast synchronization](../reference/cli/options.md#sync-mode) with [pruning](../concepts/data-storage-formats.md) enabled requires approximately 750 GB of disk space. [Full synchronization](../reference/cli/options.md#sync-mode) requires approximately 3 TB.
133+
The disk space required for syncing a Besu node depends on the
134+
[sync mode](../concepts/node-sync.md#sync-modes) and
135+
[data storage format](../concepts/data-storage-formats.md) used.
136+
The following table summarizes approximate storage estimates and download times for each configuration.
137+
138+
:::info
139+
Besu uses snap sync with history pruning enabled by default for named networks such as Mainnet and
140+
Sepolia. This configuration retains only block headers and the genesis block for
141+
[pre-merge](https://ethereum.org/en/roadmap/merge/) PoW history, significantly reducing disk usage.
142+
143+
We recommend using snap sync instead of checkpoint sync because checkpoint sync will be deprecated
144+
in the future.
145+
:::
146+
147+
| Storage format | Sync mode | World state sync time | Blockchain download time | Disk usage |
148+
|----------------|---------------------------|-----------------------|--------------------------|------------|
149+
| Bonsai | Snap (pruned) | ~3 hours | ~13 hours | 805 GB |
150+
| Bonsai | Snap (unpruned) | ~3 hours | ~26 hours (est.) | 1164 GB |
151+
| Bonsai | Checkpoint | ~3 hours | ~13 hours | >840 GB |
152+
| Forest | Full | Weeks | Weeks | ~3 TB |
134153

135154
## Disk type
136155

0 commit comments

Comments
 (0)