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.

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.

Staking troubleshootingConnectivity and port forwarding
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

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

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
Node operators, in their own words
"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."