Run a Swarm node
Contribute storage. Keep the web free.
Running a Swarm node means sharing storage and bandwidth with a decentralized network controlled by its users. This page will help you figure out whether it makes sense for you, before you read a single line of documentation.
Sharing storage and bandwidth with a network its users control. This page helps you decide if it's for you.
Last paid to one node
—
Paid to node operators
—
Recently active
- ——
- ——
- ——
Running a node at a glance
You don't need to run a full node to use Swarm, but operating one means you actively participate in keeping the network alive and share in the rewards that come from that.
What Swarm nodes do
Store encrypted fragments for others
You lend some of your disk space to the network. The network stores other people's files there. You prove you're still keeping them safe. You get paid in BZZ for doing that.
Get paid for passing files along
When someone requests a file, your node helps pass it through the network, like a relay. The more you help carry, the more credit you build up with your neighbors. That credit turns into BZZ.
Why run one
Private by design
Files are chunked into tiny pieces before they reach your node. You get one tiny piece — not the whole thing, and not anything readable. Nobody can tell what's on your drive. Not even you.
No gatekeepers
There's no signup form, no waiting list, no company deciding if you're allowed. You install the software, put up your deposit, and you're in. The network treats every node the same.
No central point of failure
Because there's no central server, there's nothing to switch off. No company can pull the plug on content simply because they don't like it. Every node that joins makes that promise a little stronger.
Early mover advantage
Nodes that have been around longer build a better reputation in their part of the network. That reputation helps when rewards are handed out.
Minimum to get started
- ~30 GB storage
- 10 xBZZ stake, not returned
- Always-on machine
- Stable and unmetered internet connectionUnmetered connection
Economics
How running a node pays off
Rewards aren’t magic — they come from real demand. Here’s how the two systems work, and what to honestly expect from each.
Storage incentives
Rewards come from demand, not from token emissions. The more data people store on Swarm, the larger the pool — and the more there is to win.
Bandwidth incentives (SWAP)
This system runs quietly in the background. The more traffic flows through your node, the more credit you accumulate.
The mechanism behind both — how storage is priced, how rounds are won, how SWAP settles — is on Tokenomics.
At current network size, meaningful profit requires operating at scale — the per-node reward is modest, and small clusters are unlikely to cover infrastructure costs today. That's the short-term reality, and it's worth going in clear-eyed.
The longer-term picture is more interesting. Rewards grow with network usage: as more data is published on Swarm, the postage stamp pool — the source of node rewards — expands. Operators who build their infrastructure and stake position now stand to benefit disproportionately from that growth.
This is an early-contributor opportunity, not a yield product. Read the monthly State of the network reports to track where the network currently sits and judge the trajectory yourself.
Before you commit
What’s the realistic upfront cost — hardware, stake, and time?
Hardware: 2+ GHz dual-core CPU, 8 GB RAM, 30 GB SSD (HDD won't cut it). On a VPS this runs $5–15/month — Hetzner, Contabo, and OVH are popular choices among operators. If you already have a home server meeting these specs, the marginal cost is near zero.
Stake and gas: 10 xBZZ minimum stake per node (non-refundable — you cannot withdraw it). A small amount of xDAI for gas (~0.01 xDAI to get started, occasional top-ups). At current prices, well under $5 total for stake and gas.
Connectivity and uptime: Your node needs a stable, unmetered internet connection and should stay online as much as possible. Nodes that go offline frequently miss redistribution rounds — rewards are proportional to availability. A home broadband connection with a data cap is likely to become a constraint.
Time: Installation takes minutes. Initial sync takes a few hours. Expect to spend a few evenings getting familiar with monitoring and the redistribution game mechanics — the docs cover the theory, but hands-on experience is where the real understanding comes from.
Resources
Not sure which node type is right for you? Ultra-light, light, and full nodes each have different capabilities and requirements. Compare node types in the docs
What brings you here?
Jump to the section most relevant to you — each one covers the same ground from a different angle.
I want to run a node at home and see how it worksHome hobbyist~30 GBSwarm Desktop~10 min
You can probably run this on gear you already have
"I want to try running a node, see what it does, maybe earn a bit."
A modern laptop, a small desktop, or a cheap VPS will work fine for a test setup. The main requirements are modest: around 30 GB of available storage, a reliable internet connection, and keeping the machine online most of the time.
Easiest startUpgradeable to a light node
Swarm Desktop
Download, install, and you're running in about 10 minutes — as long as you already have a crypto wallet and some xBZZ for the stake. No command line required. The best starting point if you want to get a feel for the network without a complicated setup.
Full participation from day oneMore setup upfront
Full Bee node
Gives you direct access to the Bee API and more configuration options. Setup takes 30–60 minutes for someone comfortable with a terminal. Detailed step-by-step instructions are in the docs.
Swarm field notes
Going deeper
How long before a new node starts earning anything?
Your node must first fully sync with the network — watch for pullsyncRate dropping to zero, which typically takes a few hours. Then you need to stake a minimum of 10 xBZZ to participate in the redistribution game. The stake is non-refundable — it's locked collateral, not spent.
Before staking, it's worth checking if your hardware is fast enough by calling the /rchash endpoint. This benchmarks how long your node takes to generate a reserve commitment hash. If durationSeconds exceeds ~360 seconds (6 minutes), your node will likely fail to submit proofs in time, resulting in missed rounds or freezing. If too slow: prioritize faster SSD first, then more RAM, then faster CPU.
From there, earnings are probabilistic — the network runs ~113 rounds/day, each selecting one neighborhood at random. Your first win could come within days or take a few weeks. It's a lottery, not a queue.
Key risk: if your node submits an incorrect reserve commitment — for example because it wasn't fully synced — it gets frozen for up to ~9 days at current storage radius. Make sure sync is complete before you stake.
What’s the most common early mistake node operators make?
Several, and they tend to compound:
• Not checking if your hardware is fast enough. Once your node is fully synced, use the /rchash endpoint to benchmark how long the sampler takes. If it exceeds ~360 seconds, your node will fail to submit proofs in time — leading to missed rounds or freezing. Fix: upgrade to SSD (ideally NVMe), add RAM, or get a faster CPU.
• Using a public/free RPC endpoint. Rate limiting or missing historical data causes the node to fall out of sync with on-chain state, leading to incorrect reserve commitments and freezing. Run your own Gnosis node or use a reliable paid provider.
• Skipping port forwarding. Port 1634 (TCP+UDP) must be reachable from the internet. If isReachable shows false in the /status endpoint, your node can't fully participate. Watch out for Carrier-Grade NAT — you may need to contact your ISP.
• Using the same Gnosis Chain address for multiple nodes. Each node needs its own address, chequebook, and ports. Sharing an address between nodes violates the protocol and breaks staking.
• Restarting during an active redistribution round. Check /redistributionstate before updating or restarting — if lastPlayedRound == round, wait for the round to complete or you risk losing winnings or getting frozen.
What happens if the node goes offline for a few days?
No disaster — but you miss earnings and need to be careful about how you go offline. Every round your node is offline, it simply doesn't participate. Rounds happen every ~12.7 minutes, so a few days means hundreds of missed chances. There's no retroactive claim.
What you don't lose: your stake stays intact (it's locked regardless), and your chunks are safe. Other nodes in your neighborhood hold copies of the same data, and pull-sync will restore your chunk inventory when you come back online.
The one danger: going offline mid-round. If your node has already submitted a commit transaction but goes down before the reveal phase, it can get frozen for up to ~9 days at current storage radius. Always check /redistributionstate before shutting down — if lastPlayedRound == round, wait for the round to complete.
Coming back online: the node will re-sync automatically via pull-sync. Once pullsyncRate drops back to zero and isFullySynced shows true, you're back in the game.
How much time does ongoing maintenance actually take per week?
Once set up properly, very little — but the initial investment in automation makes the difference.
Daily (automatable to near-zero): Check node health — isFullySynced, hasSufficientFunds, isFrozen, and that lastPlayedRound matches the current round via the /redistributionstate endpoint. Monitor xDAI balance. Bee exposes Prometheus metrics at /metrics, so all of this can run unattended with alerts via Prometheus + Grafana.
Weekly (~5–10 minutes): Cash out cheques — not automatic, requires API calls or a script. Once a week is more than sufficient; doing it too frequently is unnecessary.
Every 1–3 months (~10–30 minutes): Software upgrades. Bee stable releases come roughly every 1–5 months. The upgrade itself is straightforward (stop, upgrade, start) — always check /redistributionstate first to avoid restarting mid-round.
Bottom line: invest a couple of hours upfront setting up monitoring and a cheque cashout script, and ongoing maintenance is roughly 10–15 minutes per week for a single node. Without automation, expect more like 30 minutes of manual checking.
I run infrastructure professionally and want to evaluate SwarmProfessional operatorMulti-nodeDevOps/sysadminReference setup
Early infrastructure, real upside potential
"I run infrastructure professionally. I want the honest picture — including where this is headed."
Swarm is early-stage network infrastructure. The economics at current network scale are challenging for small deployments — but that's precisely the window where early operators have historically captured the most value in decentralized networks. The nodes running today are the ones building the reliability track record, the neighborhood depth, and the stake position that will matter as the network grows. With increased traffic on the network, bandwidth incentives are also expected to increase.
Here’s what you need to evaluate whether it’s worth getting in now.
Orchestration and tooling
Docker Compose is available for node setup. Kubernetes has been used successfully by large-scale operators in the community — if you're already running a K8s cluster and evaluating dozens or more nodes, there is no official Helm chart, but community operators at that scale have shared configurations in the Discord channel. There is no managed multi-node dashboard; expect to bring your own monitoring and automation beyond a small deployment. This is an area the tooling ecosystem is still maturing.
Where the real operational knowledge lives
The dedicated node operator channel on Discord is where experienced large-scale operators share configs, K8s setups, monitoring approaches, and actual earnings data. The official docs cover single-node setup well; everything beyond that is currently community-driven.
How we’d start today
What does a profitable multi-node operation actually look like? Levi — a core contributor who runs nodes independently with his own capital — shared his current setup as a reference point. This isn't a recommendation, it's an honest data point from someone who has tried most approaches and landed here.
Reference setup
Levi — core contributor, runs nodes independently
- Hardware
- AMD Ryzen 9 5950X (16c/32t, 128 GB RAM) or AMD EPYC 7502P (32c/64t, 192–256 GB RAM— hosted on Hetzner; older hardware with identical listed specs can perform noticeably differently from a freshly provisioned server)
- Node count
- Multiple nodes per machine, covering all neighborhoods— goal is always to have every neighborhood covered; start and stop servers to maintain this as network depth changes
- Staking strategy
- Double staking with a higher individual stake per node— Levi finds this the current "sweet spot": keeps operational costs manageable while improving reward eligibility without inflating management overhead
- Storage per node
- Reserve doubled (participating in two neighborhoods)— increases disk and bandwidth requirements; CPU and RAM overhead from the doubling itself stays minimal
- Bandwidth
- Unmetered or unlimited plan required— capped bandwidth becomes a serious cost constraint quickly; Hetzner's unmetered options work well here
- RPC
- Own Gnosis RPC (Nethermind)— relying on public endpoints at scale creates reliability risk; rate limiting causes missed rounds
- Tooling
- Docker, Zabbix, PM2, custom Bash and JS scripts— no turnkey multi-node management tools exist yet; expect to build your own monitoring and automation
Operational notes
01
Run your own RPC client
Relying on public endpoints at scale creates reliability risk. Rate limiting or missing historical data causes nodes to fall out of sync with on-chain state — leading to incorrect reserve commitments and freezing.
02
Monitor everything
Proper monitoring of your servers, nodes, contracts, and investment returns is essential. Bee exposes Prometheus metrics at /metrics — this can run unattended with alerts via Prometheus + Grafana.
03
Automate as much as you can
New strategies surface regularly and manual management doesn't scale. Automate cheque cashouts, health checks, and update workflows early. The time you invest upfront pays back immediately.
04
Understand depth’s effect on your hardware
When storage depth drops, the sampler process becomes significantly more CPU-intensive. Resource consumption is non-linear: you can't extrapolate from disk to CPU needs.
05
Stay current with releases
The network evolves fast and falling behind has real costs. Bee stable releases come roughly every 1–5 months — always check /redistributionstate before restarting to avoid losing a round mid-commit.
Next step
Bee node quickstart guide
The official setup guide covers installation, configuration, funding your node, and getting into the redistribution game. Everything you need to go from evaluation to running.
Community
Node operator channel on Discord
Where experienced operators share real configurations, troubleshoot issues, and discuss earnings. The docs cover single-node setup well — everything beyond that is currently community-driven.
Swarm field notes
Going deeper
VPS or bare metal — what do experienced operators use?
Both work, but the economics differ. Hetzner is the most commonly cited value/performance option among serious operators — particularly their dedicated servers with unmetered bandwidth. A few caveats worth knowing: not all machines with identical listed specs perform equally; older hardware that's been running for years can behave noticeably differently from a freshly provisioned server.
Bandwidth is the critical constraint. Swarm nodes are bandwidth-hungry, and capped plans can become a serious cost at scale. Prioritize providers offering unlimited or unmetered traffic over raw compute spec when comparing options.
Bare metal is worth considering once you're running enough nodes to justify it — lower per-node cost at scale, and no shared CPU contention affecting proof performance.
How does storage depth affect my hardware requirements?
Significantly, and non-linearly. Storage depth determines how large a reserve of chunks each node is responsible for. When storage depth is higher, each node's reserve is smaller — lower disk and CPU requirements. When storage depth drops, nodes take on a larger reserve, which increases storage needs and makes the redistribution game's sampler process significantly more CPU-intensive. The sampler has to compute a reserve commitment hash over a larger dataset, and CPU usage can spike dramatically at lower storage depths.
The scaling is non-linear — you can't extrapolate from disk usage to CPU needs. Memory has generally not been a bottleneck; you'll hit disk or CPU limits well before running out of RAM. The real balancing act is finding the right ratio between node count per machine and available CPU and storage headroom — and that ratio shifts as network conditions change.
How volatile are earnings month to month?
Quite volatile — several moving parts compound. On the network side: storage demand drives rewards (more postage stamps purchased = larger pool), and node count changes affect per-node share. The State of the Network reports track this monthly — check the current reports rather than relying on any specific figures here, as the range shifts as the network grows or shrinks.
On the individual node level: wins are probabilistic. The redistribution game selects one neighborhood per round — if yours is selected, one node in it wins, weighted by stake density. You might win twice one month and not at all the next.
On top of that: all earnings are in xBZZ. If you measure costs in fiat (VPS bills, electricity), the xBZZ/fiat exchange rate adds a significant additional layer of volatility on top of the network-side fluctuations.
Should I run one node or several, and does staking more per node change anything?
Multiple nodes across different neighborhoods is generally more effective than a single heavily-staked node — neighborhood coverage matters for reward eligibility. The redistribution game selects one neighborhood per round, then selects a winner from that neighborhood weighted by stake density (stake × 2^storage depth). You want presence across the network, not just depth in one spot.
On stake amount: the minimum is 10 xBZZ, but experienced operators run higher individual stakes. Nodes using reserve doubling — participating in two neighborhoods simultaneously — need 20 xBZZ. The right balance between node count, stake per node, and reserve configuration varies with network conditions; the node operator Discord channel is where current strategy is discussed most openly.
I believe in decentralized infrastructure and want to contributeIdealist / supporterAny hardwareStake optional
Your node is infrastructure for a censorship-resistant web
"The internet was decentralized once. Every node that joins Swarm is a vote for getting back there."
When you run a Swarm node, you store encrypted fragments of data from across the network. You don't know what you're storing — and neither does anyone else. That's not a limitation. It's what makes the network private, neutral, and impossible to censor at the infrastructure level.
Every node that comes online makes the network harder to shut down, more resilient against data loss, and more useful for the people who depend on it — journalists, open-source projects, non-profits, and anyone who needs their data to survive without a corporate intermediary.
Swarm Desktop
Runs a light node — you upload and download as a true peer on the network, paying for storage with postage stamps. You participate in SWAP bandwidth accounting with your peers. You don't store data for others or provide bandwidth to the network.
Minimum to get started
- Hardware
- Any computer that can run the app
- Storage
- A few GB free
- Setup time
- ~10 minutes
Full Bee node
Stores data for others, relays traffic, and actively contributes to the network's resilience. Staking 10 xBZZ makes you eligible for redistribution game rewards — but you can run a full node and contribute without staking.
Minimum requirements
- Hardware
- Always-on machine, stable unmetered connection
- Storage
- ~30 GB SSD
- Staking nodes
- Higher requirements — see the pro operator section
Swarm field notes
Going deeper
How long before a new node starts earning anything?
Your node must first fully sync with the network — watch for pullsyncRate dropping to zero, which typically takes a few hours. Then you need to stake a minimum of 10 xBZZ to participate in the redistribution game. The stake is non-refundable — it's locked collateral, not spent.
Before staking, it's worth checking if your hardware is fast enough by calling the /rchash endpoint. This benchmarks how long your node takes to generate a reserve commitment hash. If durationSeconds exceeds ~360 seconds (6 minutes), your node will likely fail to submit proofs in time, resulting in missed rounds or freezing. If too slow: prioritize faster SSD first, then more RAM, then faster CPU.
From there, earnings are probabilistic — the network runs ~113 rounds/day, each selecting one neighborhood at random. Your first win could come within days or take a few weeks. It's a lottery, not a queue.
Key risk: if your node submits an incorrect reserve commitment — for example because it wasn't fully synced — it gets frozen for up to ~9 days at current storage radius. Make sure sync is complete before you stake.
What happens if the node goes offline for a few days?
No disaster — but you miss earnings and need to be careful about how you go offline. Every round your node is offline, it simply doesn't participate. Rounds happen every ~12.7 minutes, so a few days means hundreds of missed chances. There's no retroactive claim.
What you don't lose: your stake stays intact (it's locked regardless), and your chunks are safe. Other nodes in your neighborhood hold copies of the same data, and pull-sync will restore your chunk inventory when you come back online.
The one danger: going offline mid-round. If your node has already submitted a commit transaction but goes down before the reveal phase, it can get frozen for up to ~9 days at current storage radius. Always check /redistributionstate before shutting down — if lastPlayedRound == round, wait for the round to complete.
Coming back online: the node will re-sync automatically via pull-sync. Once pullsyncRate drops back to zero and isFullySynced shows true, you're back in the game.
I’m building on Swarm and want to understand whether I need to run a nodeDeveloper / builder
You probably don’t need to run a node to start
"I'm building on Swarm. I want to connect my app, not manage infrastructure.”
The public Swarm gateway lets you upload and retrieve data without running anything locally — no wallet, no stake, no setup. It's the fastest way to test an integration and see how Swarm behaves. When you're ready to go further, there are three paths depending on what you're building and how much control you need.
Your home on this site
Developer Hub
dApps, tools, libs, APIs, and clients — the full Swarm developer stack in one place. Covers Bee‑js, Swarm CLI, the Bee API, and everything already running on the network.
Local dev
Swarm Desktop
A desktop app that runs a Swarm node with a built-in interface — no command line setup required. Starts in ultra-light mode (download only). Fund your node wallet with xDAI to upgrade to light mode and unlock uploads and full API access.
Production
Full Bee node
Full API access, participates in the network directly. Requires a 10 xBZZ stake and ~30 GB storage. Use this when you need independence from a third-party gateway, or when you're running at a scale where it makes economic sense.
JavaScript / TypeScript
Bee.js
The official JavaScript client library for the Bee API. Upload files, manage stamps, interact with feeds and access control — all through a clean SDK rather than raw HTTP calls. The fastest path for web developers.
Tools for node operators
The essentials, and where to find the rest
A handful of tools are worth knowing about before you start. Beyond these, the community maintains a living list of everything in the ecosystem — that's the right place to discover what else exists, because it stays current in a way a webpage can't.
Swarm Desktop
The easiest way to run a node. Installs and manages a Bee node for you — no terminal needed. The right starting point for hobbyists and anyone wanting to get running in 10 minutes.
docs.ethswarm.org/
docs/ desktop/ introduction SwarmScan
Live network explorer. Shows active node count, neighborhood depth, and reward data. The first place to check network health and understand where your node sits relative to the rest of the network.
swarmscan.io
Swarm CLI
Command-line tool for everything: node status, staking, stamp management, balance checks. swarm‑cli status gives a full health snapshot in one command. Essential for anyone running without Swarm Desktop.
GitHub
Etherproxy
Reverse proxy that batches repeated RPC calls from multiple nodes into one request. Dramatically cuts Gnosis Chain RPC usage — saves money on paid endpoints and reduces load. Especially useful once you're running more than one node.
GitHub
More tools
The Swarm ecosystem includes CLI toolkits, node health checkers, multi-node managers, Kubernetes orchestration, IPFS migration tools, and more — maintained by both the core team and the community. The full list lives on GitHub and is kept up to date by contributors.
GitHub
Community
Join other node operators
It's also where the Swarm core team listens. Operator feedback from the channel has directly shaped tooling decisions and protocol changes. If you have opinions about what's missing, this is the room.
- Setup help
- Earnings discussion
- Config sharing
- Troubleshooting
- Multi-node tips
- Core team present
"There are times when it costs you a few days and some headaches, and there are times when you just sit back and enjoy the harvest for weeks. The whole experience is genuinely exciting. It's new, it's challenging, and it's getting better as the ecosystem matures."
Where to go next
Node operators are one part of the picture
DocumentationStart your first node
The setup guide and configuration reference - everything you need to get your first node running, when you are ready to start.
TokenomicsCheck the economics first
How postage stamps fund the reward pool, how the redistribution game pays out, and what drives the value of BZZ over time.
Inside SwarmUnderstand what you run
Chunk storage, neighborhood routing, incentive design. For operators who want to understand what they are running, not just how.
Developer HubShip something on top
The network needs applications as well as nodes. What you can build today on the infrastructure you already run, and the tools to do it.