From 990ad4bc941be9bc4fce7f9c9c150e4b684ea9a6 Mon Sep 17 00:00:00 2001 From: Paradigm AI Date: Thu, 16 Apr 2026 09:44:22 +0000 Subject: [PATCH 1/2] docs: recommend TCP fq qdisc + BBR congestion control for validators Add a Network Tuning section to the system requirements page with instructions for enabling fq+bbr at runtime and persisting across reboots. This improves P2P and consensus throughput/latency. Amp-Thread-ID: https://ampcode.com/threads/T-019d957c-96e6-707b-8f0e-fa79fed00613 Co-authored-by: Amp --- src/pages/guide/node/system-requirements.mdx | 37 ++++++++++++++++++++ 1 file changed, 37 insertions(+) diff --git a/src/pages/guide/node/system-requirements.mdx b/src/pages/guide/node/system-requirements.mdx index f2a89423..8b1a974b 100644 --- a/src/pages/guide/node/system-requirements.mdx +++ b/src/pages/guide/node/system-requirements.mdx @@ -50,6 +50,43 @@ We do not recommend using a cloud firewall / NAT gateway as it can introduce add - ratelimiting connections and messages in consensus and execution to prevent abuse - only accepting consensus connections from validators that can prove their identity +## Network Tuning + +For optimal P2P and consensus performance we recommend switching the TCP congestion-control algorithm to **BBR** and the packet scheduler (qdisc) to **fq**. Together they reduce latency and improve throughput, especially on high-bandwidth links. + +### Apply at runtime (resets on reboot) + +```bash +sudo sysctl -w net.core.default_qdisc=fq +sudo sysctl -w net.ipv4.tcp_congestion_control=bbr +``` + +### Persist across reboots + +Add the following to your sysctl configuration (e.g. `/etc/sysctl.d/99-tempo-network.conf` or equivalent): + +```ini +net.core.default_qdisc = fq +net.ipv4.tcp_congestion_control = bbr +``` + +Then reload: + +```bash +sudo sysctl --system +``` + +### Verify + +```bash +sysctl net.ipv4.tcp_congestion_control # should print: bbr +sysctl net.core.default_qdisc # should print: fq +``` + +:::info +BBR requires Linux kernel ≥ 4.9. All recommended cloud providers listed above ship kernels that support it out of the box. +::: + ## Ports | Port | Protocol | Purpose | Expose | From d9dae8a3300dfe2fdd444d2c0255b0be33607da9 Mon Sep 17 00:00:00 2001 From: Paradigm AI Date: Thu, 16 Apr 2026 09:55:18 +0000 Subject: [PATCH 2/2] docs: simplify network tuning section, add restart note Amp-Thread-ID: https://ampcode.com/threads/T-019d957c-96e6-707b-8f0e-fa79fed00613 Co-authored-by: Amp --- src/pages/guide/node/system-requirements.mdx | 22 +++----------------- 1 file changed, 3 insertions(+), 19 deletions(-) diff --git a/src/pages/guide/node/system-requirements.mdx b/src/pages/guide/node/system-requirements.mdx index 8b1a974b..b8a746b1 100644 --- a/src/pages/guide/node/system-requirements.mdx +++ b/src/pages/guide/node/system-requirements.mdx @@ -52,16 +52,7 @@ We do not recommend using a cloud firewall / NAT gateway as it can introduce add ## Network Tuning -For optimal P2P and consensus performance we recommend switching the TCP congestion-control algorithm to **BBR** and the packet scheduler (qdisc) to **fq**. Together they reduce latency and improve throughput, especially on high-bandwidth links. - -### Apply at runtime (resets on reboot) - -```bash -sudo sysctl -w net.core.default_qdisc=fq -sudo sysctl -w net.ipv4.tcp_congestion_control=bbr -``` - -### Persist across reboots +We recommend enabling TCP **BBR** congestion control with the **fq** packet scheduler for better P2P and consensus performance. Add the following to your sysctl configuration (e.g. `/etc/sysctl.d/99-tempo-network.conf` or equivalent): @@ -70,22 +61,15 @@ net.core.default_qdisc = fq net.ipv4.tcp_congestion_control = bbr ``` -Then reload: +Apply and verify: ```bash sudo sysctl --system -``` - -### Verify - -```bash sysctl net.ipv4.tcp_congestion_control # should print: bbr sysctl net.core.default_qdisc # should print: fq ``` -:::info -BBR requires Linux kernel ≥ 4.9. All recommended cloud providers listed above ship kernels that support it out of the box. -::: +Restart the node after applying for the changes to take effect. ## Ports