Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
44 commits
Select commit Hold shift + click to select a range
21d5e01
Add system parachain RPC guide and enhance documentation
brunopgalvao Nov 18, 2025
43339dc
Merge branch 'staging/product-ia' into bruno/infra/running-a-collator
brunopgalvao Nov 18, 2025
cb3ac55
Update system parachain RPC guide to latest versions
brunopgalvao Nov 19, 2025
6dc4298
Merge staging/product-ia into bruno/infra/running-a-collator
brunopgalvao Nov 19, 2025
9105f65
Update software versions and dependencies
brunopgalvao Nov 19, 2025
ed97e71
Update content
brunopgalvao Nov 20, 2025
656920e
initial look at collator.md
dawnkelly09 Nov 20, 2025
b04156a
tweak admo
dawnkelly09 Nov 20, 2025
dbd2d98
wip - collator page
dawnkelly09 Nov 21, 2025
fc25788
finish collator pre-tech review pass
dawnkelly09 Nov 21, 2025
2de9f46
clean up formatting for RPC node page
dawnkelly09 Nov 21, 2025
3b791ac
formatting edits
dawnkelly09 Nov 21, 2025
b84d71d
Update guides
brunopgalvao Nov 24, 2025
7870c65
Merge remote changes with tabbed content structure
brunopgalvao Nov 24, 2025
a9f8340
Use polkadot-parachain binary instead of polkadot-omni-node
brunopgalvao Nov 24, 2025
35d51a0
Update llms
brunopgalvao Nov 24, 2025
fda3e1c
Download polkadot-parachain binary from GitHub releases instead of Do…
brunopgalvao Nov 24, 2025
e517594
Use MkDocs admonition syntax for notes and warnings
brunopgalvao Nov 24, 2025
1c3288f
Fix GitHub release tag to polkadot-stable2509-2
brunopgalvao Nov 24, 2025
1859915
Restructure parachain-rpc.md to use tabbed content layout
brunopgalvao Nov 24, 2025
f645cca
Add Docker commands to collator.md monitoring and maintenance sections
brunopgalvao Nov 24, 2025
1a74bf4
Update content
brunopgalvao Nov 24, 2025
6822d57
wip rpc page cleanup
dawnkelly09 Nov 24, 2025
65132ed
Update content
brunopgalvao Nov 26, 2025
1f55b3e
Merge remote-tracking branch 'origin/staging/product-ia' into bruno/i…
brunopgalvao Dec 4, 2025
ad7ac4d
Update node configs: optimize pruning, disable external ports
brunopgalvao Dec 4, 2025
5569d63
Update AI index pages for node infrastructure docs
brunopgalvao Dec 4, 2025
1218571
Update snapshot URLs and storage requirements for node docs
brunopgalvao Dec 9, 2025
decf9d5
Simplify snapshot sections to single archive instructions
brunopgalvao Dec 9, 2025
41f3548
Add Docker setup option for collator deployment
brunopgalvao Dec 9, 2025
9a200f2
LLMS files
brunopgalvao Dec 9, 2025
1993fdb
cleanup docs
eshaben Dec 9, 2025
10dc550
Merge remote-tracking branch 'origin/bruno/infra/running-a-collator' …
eshaben Dec 9, 2025
cc37481
add bruno's changes to my changes
eshaben Dec 9, 2025
88cd077
add bruno's changes to my changes
eshaben Dec 9, 2025
8485f32
fix link
eshaben Dec 9, 2025
0ad288c
update parachain rpc page
eshaben Dec 11, 2025
0d70948
update polkadot hub rpc page
eshaben Dec 11, 2025
5fb1690
fix full node terminal elements
eshaben Dec 11, 2025
5644b85
update collator page
eshaben Dec 11, 2025
59603f1
resolve TODOs
eshaben Dec 11, 2025
3f78b60
fix capitalization
eshaben Dec 11, 2025
979be37
fix: images
nhussein11 Dec 11, 2025
f7838df
update content
brunopgalvao Dec 12, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2,327 changes: 159 additions & 2,168 deletions .ai/categories/basics.md

Large diffs are not rendered by default.

3,786 changes: 247 additions & 3,539 deletions .ai/categories/dapps.md

Large diffs are not rendered by default.

2,633 changes: 128 additions & 2,505 deletions .ai/categories/infrastructure.md

Large diffs are not rendered by default.

2,625 changes: 124 additions & 2,501 deletions .ai/categories/networks.md

Large diffs are not rendered by default.

2,235 changes: 107 additions & 2,128 deletions .ai/categories/parachains.md

Large diffs are not rendered by default.

3,235 changes: 140 additions & 3,095 deletions .ai/categories/polkadot-protocol.md

Large diffs are not rendered by default.

493 changes: 0 additions & 493 deletions .ai/categories/reference.md

Large diffs are not rendered by default.

2,906 changes: 83 additions & 2,823 deletions .ai/categories/smart-contracts.md

Large diffs are not rendered by default.

6,252 changes: 1,152 additions & 5,100 deletions .ai/categories/tooling.md

Large diffs are not rendered by default.

666 changes: 666 additions & 0 deletions .ai/pages/node-infrastructure-run-a-collator.md

Large diffs are not rendered by default.

488 changes: 488 additions & 0 deletions .ai/pages/node-infrastructure-run-a-node-parachain-rpc.md

Large diffs are not rendered by default.

458 changes: 458 additions & 0 deletions .ai/pages/node-infrastructure-run-a-node-polkadot-hub-rpc.md

Large diffs are not rendered by default.

Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: Set Up a Bootnode
description: Learn how to configure and run a bootnode for Polkadot, including P2P, WS, and secure WSS connections with network key management and proxies.
categories: Infrastructure
url: https://docs.polkadot.com/nodes-and-validators/run-a-node/bootnode/
url: https://docs.polkadot.com/node-infrastructure/run-a-node/relay-chain/bootnode/
---

# Set Up a Bootnode
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: Set Up a Node
description: Learn how to install, configure, and run Polkadot nodes, including setting up different node types and connecting to the network.
categories: Infrastructure
url: https://docs.polkadot.com/nodes-and-validators/run-a-node/full-node/
url: https://docs.polkadot.com/node-infrastructure/run-a-node/relay-chain/full-node/
---

# Set Up a Node
Expand All @@ -27,7 +27,7 @@ Before getting started, ensure the following prerequisites are met:
- [Install the necessary dependencies for the Polkadot SDK](/parachains/install-polkadot-sdk/){target=\_blank}.

!!! warning
This setup is not recommended for validators. If you plan to run a validator, refer to the [Running a Validator](/nodes-and-validators/run-a-validator/onboarding-and-offboarding/set-up-validator/){target=\_blank} guide for proper instructions.
This setup is not recommended for validators. If you plan to run a validator, refer to the [Running a Validator](/node-infrastructure/run-a-validator/onboarding-and-offboarding/set-up-validator/){target=\_blank} guide for proper instructions.

### Install and Build the Polkadot Binary

Expand Down Expand Up @@ -58,10 +58,9 @@ This section will walk you through installing and building the Polkadot binary f
You should see output similar to the following:

<div id="termynal" data-termynal>
<span data-ty="input"
><span class="file-path"></span>rustup show <br />
rustup +nightly show</span
>
<span data-ty="input"><span class="file-path"></span>rustup show</span>
<span data-ty>rustup +nightly show</span>
<span data-ty></span>
<span data-ty>active toolchain</span>
<span data-ty>----------------</span>
<span data-ty></span>
Expand Down Expand Up @@ -143,10 +142,8 @@ This section will walk you through installing and building the Polkadot binary f
You should see output similar to the following:

<div id="termynal" data-termynal>
<span data-ty="input"
><span class="file-path"></span>rustup show <br />
rustup +nightly show</span
>
<span data-ty="input"><span class="file-path"></span>rustup show</span>
<span data-ty></span>
<span data-ty>active toolchain</span>
<span data-ty>----------------</span>
<span data-ty></span>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: Set Up Secure WebSocket
description: Instructions on enabling SSL for your node and setting up a secure WebSocket proxy server using nginx for remote connections.
categories: Infrastructure
url: https://docs.polkadot.com/nodes-and-validators/run-a-node/secure-wss/
url: https://docs.polkadot.com/node-infrastructure/run-a-node/relay-chain/secure-wss/
---

# Set Up Secure WebSocket
Expand Down Expand Up @@ -122,4 +122,4 @@ Apache2 can run in various modes, including `prefork`, `worker`, and `event`. In
wss://example.com:443
```

![A sync-in-progress chain connected to Polkadot.js UI](/images/nodes-and-validators/run-a-node/secure-wss/secure-wss-01.webp)
![A sync-in-progress chain connected to Polkadot.js UI](/images/node-infrastructure/run-a-node/secure-wss/secure-wss-01.webp)
Original file line number Diff line number Diff line change
Expand Up @@ -2,14 +2,14 @@
title: Validator Key Management
description: Learn how to generate and manage validator keys, including session keys for consensus participation and node keys for maintaining a stable network identity.
categories: Infrastructure
url: https://docs.polkadot.com/nodes-and-validators/run-a-validator/onboarding-and-offboarding/key-management/
url: https://docs.polkadot.com/node-infrastructure/run-a-validator/onboarding-and-offboarding/key-management/
---

# Key Management

## Introduction

After setting up your node environment as shown in the [Setup](/nodes-and-validators/run-a-validator/onboarding-and-offboarding/set-up-validator/){target=\_blank} section, you'll need to configure multiple keys for your validator to operate properly. This includes setting up session keys, which are essential for participating in the consensus process, and configuring a node key that maintains a stable network identity. This guide walks you through the key management process, showing you how to generate, store, and register these keys.
After setting up your node environment as shown in the [Setup](/node-infrastructure/run-a-validator/onboarding-and-offboarding/set-up-validator/){target=\_blank} section, you'll need to configure multiple keys for your validator to operate properly. This includes setting up session keys, which are essential for participating in the consensus process, and configuring a node key that maintains a stable network identity. This guide walks you through the key management process, showing you how to generate, store, and register these keys.

## Set Session Keys

Expand All @@ -30,7 +30,7 @@ There are multiple ways to create the session keys. It can be done by interactin
3. Click the **Submit RPC Call** button.
4. Copy the hex-encoded public key from the response.

![](/images/nodes-and-validators/run-a-validator/onboarding-and-offboarding/key-management/key-management-01.webp)
![](/images/node-infrastructure/run-a-validator/onboarding-and-offboarding/key-management/key-management-01.webp)

=== "Curl"

Expand Down Expand Up @@ -89,7 +89,7 @@ Now that you have generated your session keys, you must submit them to the chain
2. Select **Set Session Key** on the bonding account you generated earlier.
3. Paste the hex-encoded session key string you generated (from either the UI or CLI) into the input field and submit the transaction.

![](/images/nodes-and-validators/run-a-validator/onboarding-and-offboarding/key-management/key-management-02.webp)
![](/images/node-infrastructure/run-a-validator/onboarding-and-offboarding/key-management/key-management-02.webp)

Once the transaction is signed and submitted, your session keys will be registered on-chain.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: Set Up a Validator
description: Set up a Polkadot validator node to secure the network and earn staking rewards. Follow this step-by-step guide to install, configure, and manage your node.
categories: Infrastructure
url: https://docs.polkadot.com/nodes-and-validators/run-a-validator/onboarding-and-offboarding/set-up-validator/
url: https://docs.polkadot.com/node-infrastructure/run-a-validator/onboarding-and-offboarding/set-up-validator/
---

# Set Up a Validator
Expand All @@ -17,10 +17,10 @@ Running a validator requires a commitment to maintaining a stable, secure infras

To get the most from this guide, ensure you've done the following before going forward:

- Read [Validator Requirements](/nodes-and-validators/run-a-validator/requirements/){target=\_blank} and understand the recommended minimum skill level and hardware needs.
- Read [General Management](/nodes-and-validators/run-a-validator/operational-tasks/general-management/){target=\_blank}, [Upgrade Your Node](/nodes-and-validators/run-a-validator/operational-tasks/upgrade-your-node/){target=\_blank}, and [Pause Validating](/nodes-and-validators/run-a-validator/operational-tasks/pause-validating/){target=\_blank} and understand the tasks required to keep your validator operational.
- Read [Rewards Payout](/nodes-and-validators/run-a-validator/staking-mechanics/rewards/){target=\_blank} and understand how validator rewards are determined and paid out.
- Read [Offenses and Slashes](/nodes-and-validators/run-a-validator/staking-mechanics/offenses-and-slashes/){target=\_blank} and understand how validator performance and security can affect tokens staked by you or your nominators.
- Read [Validator Requirements](/node-infrastructure/run-a-validator/requirements/){target=\_blank} and understand the recommended minimum skill level and hardware needs.
- Read [General Management](/node-infrastructure/run-a-validator/operational-tasks/general-management/){target=\_blank}, [Upgrade Your Node](/node-infrastructure/run-a-validator/operational-tasks/upgrade-your-node/){target=\_blank}, and [Pause Validating](/node-infrastructure/run-a-validator/operational-tasks/pause-validating/){target=\_blank} and understand the tasks required to keep your validator operational.
- Read [Rewards Payout](/node-infrastructure/run-a-validator/staking-mechanics/rewards/){target=\_blank} and understand how validator rewards are determined and paid out.
- Read [Offenses and Slashes](/node-infrastructure/run-a-validator/staking-mechanics/offenses-and-slashes/){target=\_blank} and understand how validator performance and security can affect tokens staked by you or your nominators.

## Initial Setup

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,14 +2,14 @@
title: Start Validating
description: Learn how to start validating on Polkadot by choosing a network, syncing your node, bonding DOT tokens, and activating your validator.
categories: Infrastructure
url: https://docs.polkadot.com/nodes-and-validators/run-a-validator/onboarding-and-offboarding/start-validating/
url: https://docs.polkadot.com/node-infrastructure/run-a-validator/onboarding-and-offboarding/start-validating/
---

# Start Validating

## Introduction

After configuring your node keys as shown in the [Key Management](/nodes-and-validators/run-a-validator/onboarding-and-offboarding/key-management/){target=\_blank} section and ensuring your system is set up, you're ready to begin the validator setup process. This guide will walk you through choosing a network, synchronizing your node with the blockchain, bonding your DOT tokens, and starting your validator.
After configuring your node keys as shown in the [Key Management](/node-infrastructure/run-a-validator/onboarding-and-offboarding/key-management/){target=\_blank} section and ensuring your system is set up, you're ready to begin the validator setup process. This guide will walk you through choosing a network, synchronizing your node with the blockchain, bonding your DOT tokens, and starting your validator.

## Choose a Network

Expand Down Expand Up @@ -99,7 +99,7 @@ If you see terminal output similar to the preceding, and you are unable to synch

## Bond DOT

Once your validator node is synced, the next step is bonding DOT. A bonded account, or stash, holds your staked tokens (DOT) that back your validator node. Bonding your DOT means locking it for a period, during which it cannot be transferred or spent but is used to secure your validator's role in the network. Visit the [Minimum Bond Requirement](/nodes-and-validators/run-a-validator/requirements/#minimum-bond-requirement) section for details on how much DOT is required.
Once your validator node is synced, the next step is bonding DOT. A bonded account, or stash, holds your staked tokens (DOT) that back your validator node. Bonding your DOT means locking it for a period, during which it cannot be transferred or spent but is used to secure your validator's role in the network. Visit the [Minimum Bond Requirement](/node-infrastructure/run-a-validator/requirements/#minimum-bond-requirement) section for details on how much DOT is required.

The following sections will guide you through bonding DOT for your validator.

Expand Down Expand Up @@ -131,29 +131,29 @@ Follow these steps to use Polkadot.js Apps to activate your validator:

1. In Polkadot.js Apps, navigate to **Network** and select **Staking**:

![](/images/nodes-and-validators/run-a-validator/onboarding-and-offboarding/start-validating/start-validating-01.webp)
![](/images/node-infrastructure/run-a-validator/onboarding-and-offboarding/start-validating/start-validating-01.webp)

2. Open the **Accounts** tab and click on **+ Validator**:

![](/images/nodes-and-validators/run-a-validator/onboarding-and-offboarding/start-validating/start-validating-02.webp)
![](/images/node-infrastructure/run-a-validator/onboarding-and-offboarding/start-validating/start-validating-02.webp)

3. Set a bond amount in the **value bonded** field and then click **next**:

![](/images/nodes-and-validators/run-a-validator/onboarding-and-offboarding/start-validating/start-validating-03.webp)
![](/images/node-infrastructure/run-a-validator/onboarding-and-offboarding/start-validating/start-validating-03.webp)

4. Paste the hex output from `author_rotateKeys`, set the commission, allow or block new nominations, then click **Bond & Validate** to link your validator with its session keys.

![](/images/nodes-and-validators/run-a-validator/onboarding-and-offboarding/start-validating/start-validating-04.webp)
![](/images/node-infrastructure/run-a-validator/onboarding-and-offboarding/start-validating/start-validating-04.webp)

You can also set the **commission** and **blocked** nominations option via `staking.validate` extrinsic. By default, the blocked option is set to FALSE (i.e., the validator accepts nominations).

![](/images/nodes-and-validators/run-a-validator/onboarding-and-offboarding/start-validating/start-validating-05.webp)
![](/images/node-infrastructure/run-a-validator/onboarding-and-offboarding/start-validating/start-validating-05.webp)

### Monitor Validation Status and Slots

On the [**Staking**](https://polkadot.js.org/apps/#/staking){target=\_blank} tab in Polkadot.js Apps, you can see your validator's status, the number of available validator slots, and the nodes that have signaled their intent to validate. Your node may initially appear in the waiting queue, especially if the validator slots are full. The following is an example view of the **Staking** tab:

![staking queue](/images/nodes-and-validators/run-a-validator/onboarding-and-offboarding/start-validating/start-validating-06.webp)
![staking queue](/images/node-infrastructure/run-a-validator/onboarding-and-offboarding/start-validating/start-validating-06.webp)

The validator set refreshes each era. If there's an available slot in the next era, your node may be selected to move from the waiting queue to the active validator set, allowing it to start validating blocks. If your validator is not selected, it remains in the waiting queue. Increasing your stake or gaining more nominators may improve your chance of being selected in future eras.

Expand All @@ -165,7 +165,7 @@ This following sections will walk you through creating and managing a systemd se

Ensure the following requirements are met before proceeding with the systemd setup:

- Confirm your system meets the [requirements](/nodes-and-validators/run-a-validator/requirements/){target=\_blank} for running a validator.
- Confirm your system meets the [requirements](/node-infrastructure/run-a-validator/requirements/){target=\_blank} for running a validator.
- Ensure you meet the [minimum bond requirements](https://wiki.polkadot.com/general/chain-state-values/#minimum-validator-bond){target=\_blank} for validating.
- Verify the Polkadot binary is [installed](#install-the-polkadot-binaries).

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: Stop Validating
description: Learn to safely stop validating on Polkadot, including chilling, unbonding tokens, and purging validator keys.
categories: Infrastructure
url: https://docs.polkadot.com/nodes-and-validators/run-a-validator/onboarding-and-offboarding/stop-validating/
url: https://docs.polkadot.com/node-infrastructure/run-a-validator/onboarding-and-offboarding/stop-validating/
---

# Stop Validating
Expand All @@ -25,7 +25,7 @@ The following are steps to ensure a smooth stop to validation:

When stepping back from validating, the first step is to chill your validator status. This action stops your validator from being considered for the next era without fully unbonding your tokens, which can be useful for temporary pauses like maintenance or planned downtime.

Use the `staking.chill` extrinsic to initiate this. For more guidance on chilling your node, refer to the [Pause Validating](/nodes-and-validators/run-a-validator/operational-tasks/pause-validating/){target=\_blank} guide. You may also claim any pending staking rewards at this point.
Use the `staking.chill` extrinsic to initiate this. For more guidance on chilling your node, refer to the [Pause Validating](/node-infrastructure/run-a-validator/operational-tasks/pause-validating/){target=\_blank} guide. You may also claim any pending staking rewards at this point.

## Purge Validator Session Keys

Expand Down
Loading
Loading