# @ethersphere/bee-dashboard > An app which helps users to setup their Bee node and do actions like cash out cheques Latest version **0.37.0** (published 2026-09-07) · BSD-3-Clause license · 0 weekly downloads ## Install ```sh npm install @ethersphere/bee-dashboard pnpm add @ethersphere/bee-dashboard yarn add @ethersphere/bee-dashboard bun add @ethersphere/bee-dashboard ``` Provides the command `bee-dashboard`. ## Health **Score 75/100 (B)** — status: active. Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score. Warnings: low downloads; large bundle; pre 1.0. ## Facts | | | |---|---| | Version | 0.37.0 | | Published | 2026-09-07 | | First published | 2021-04-29 | | Weekly downloads | 0 | | License | BSD-3-Clause | | TypeScript types | bundled | | Module format | ESM + CommonJS | | Node | >=24.0.0 | | Dependencies | 22 | | Unpacked size | 16.7 MB | | Known vulnerabilities | 0 | | Install scripts | no | | Provenance | attested (GitHub Actions) | | GitHub stars | 141 | | Maintainers | ethersphereowner, ethswarm-devops | | Keywords | bee, swarm, decentralised, storage, ethereum, typescript, p2p | ## Links - npm: https://www.npmjs.com/package/@ethersphere/bee-dashboard - Repository: https://github.com/ethersphere/bee-dashboard - Homepage: http://. - Issues: https://github.com/ethersphere/bee-dashboard/issues/ - npm.io page: https://npm.io/package/@ethersphere/bee-dashboard ## Dependencies (22) - [axios](https://npm.io/package/axios.md) ^1.16.1 - [jszip](https://npm.io/package/jszip.md) ^3.10.1 - [ethers](https://npm.io/package/ethers.md) ^6.16.0 - [formik](https://npm.io/package/formik.md) 2.4.9 - [opener](https://npm.io/package/opener.md) 1.5.2 - [notistack](https://npm.io/package/notistack.md) ^3.0.2 - [dotted-map](https://npm.io/package/dotted-map.md) ^2.2.3 - [file-saver](https://npm.io/package/file-saver.md) ^2.0.5 - [formik-mui](https://npm.io/package/formik-mui.md) ^5.0.0-alpha.1 - [bignumber.js](https://npm.io/package/bignumber.js.md) ^9.3.1 - [@mui/material](https://npm.io/package/@mui/material.md) ^7.3.7 - [react-qr-code](https://npm.io/package/react-qr-code.md) ^2.0.18 - [serve-handler](https://npm.io/package/serve-handler.md) 6.1.7 - [@emotion/react](https://npm.io/package/@emotion/react.md) ^11.14.0 - [@formbricks/js](https://npm.io/package/@formbricks/js.md) ^4.3.0 - [react-dropzone](https://npm.io/package/react-dropzone.md) ^14.4.0 - [@emotion/styled](https://npm.io/package/@emotion/styled.md) ^11.14.1 - [remixicon-react](https://npm.io/package/remixicon-react.md) ^1.0.0 - [@ethersphere/bee-js](https://npm.io/package/@ethersphere/bee-js.md) ^13.0.0 - [@mui/icons-material](https://npm.io/package/@mui/icons-material.md) ^7.3.7 - [react-syntax-highlighter](https://npm.io/package/react-syntax-highlighter.md) 16.1.0 - [@solarpunkltd/file-manager-lib](https://npm.io/package/@solarpunkltd/file-manager-lib.md) ^1.1.0 ## Alternatives - [@openai/codex-sdk](https://npm.io/package/@openai/codex-sdk.md) — 731.4K weekly downloads - [babel-plugin-transform-react-jsx](https://npm.io/package/babel-plugin-transform-react-jsx.md) — 565.0K weekly downloads - [babel-helper-remove-or-void](https://npm.io/package/babel-helper-remove-or-void.md) — 508.5K weekly downloads - [@pnpm/store-controller-types](https://npm.io/package/@pnpm/store-controller-types.md) — 186.9K weekly downloads - [react-native-signature-canvas](https://npm.io/package/react-native-signature-canvas.md) — 155.6K weekly downloads ## Recent versions - 0.37.0 (latest) — 2026-09-07 - 0.36.2 — 2026-07-22 - 0.36.1 — 2026-07-20 - 0.36.0 — 2026-07-14 - 0.35.2 — 2026-07-07 - 0.35.1 — 2026-04-10 - 0.35.0 — 2026-04-02 - 0.34.0 — 2026-03-20 - 0.33.5 — 2026-02-17 - 0.33.4 — 2026-01-26 - 0.33.3 — 2025-11-17 - 0.33.2 — 2025-11-14 - 0.33.1 — 2025-11-13 - 0.33.0 — 2025-11-12 - 0.32.0 — 2025-03-12 - … 44 more at https://npm.io/package/@ethersphere/bee-dashboard/versions ## README # Bee Dashboard [![](https://img.shields.io/badge/made%20by-Swarm-blue.svg?style=flat-square)](https://swarm.ethereum.org/) [![standard-readme compliant](https://img.shields.io/badge/standard--readme-OK-brightgreen.svg?style=flat-square)](https://github.com/RichardLitt/standard-readme) [![js-standard-style](https://img.shields.io/badge/code%20style-standard-brightgreen.svg?style=flat-square)](https://github.com/feross/standard) [![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fethersphere%2Fbee-dashboard.svg?type=shield)](https://app.fossa.com/projects/git%2Bgithub.com%2Fethersphere%2Fbee-dashboard?ref=badge_shield) ![](https://img.shields.io/badge/pnpm-%3E%3D10.0.0-orange.svg?style=flat-square) ![](https://img.shields.io/badge/Node.js-%3E%3D24.0.0-orange.svg?style=flat-square) > An app which helps users to setup their Bee node and do actions like cash out cheques, upload and download files or > manage your postage stamps. Stay up to date by joining the [official Discord](https://discord.gg/GU22h2utj6) and by keeping an eye on the [releases tab](https://github.com/ethersphere/bee-dashboard/releases). ![Status page](/docs/ui_samples/info.png) | Node Setup | Upload Files | Download Content | Accounting | Settings | File Manager | | ----------------------------------------- | ------------------------------------------- | ----------------------------------------------- | ---------------------------------------------- | ------------------------------------------ | -------------------------------------------------- | | ![Setup](/docs/ui_samples/node_setup.png) | ![Upload](/docs/ui_samples/file_upload.png) | ![Download](/docs/ui_samples/file_download.png) | ![Accounting](/docs/ui_samples/accounting.png) | ![Settings](/docs/ui_samples/settings.png) | ![File Manager](/docs/ui_samples/file_manager.png) | ## Table of Contents - [Install](#install) - [Usage](#usage) - [Terminal](#terminal) - [Docker](#docker) - [Development](#development) - [File Manager](#file-manager) - [Contribute](#contribute) - [Maintainers](#maintainers) - [License](#license) ## Install Install globally with pnpm. We require Node.js's version of at least 24.x and pnpm v10.x, npm v11.x. ```sh pnpm add -g @ethersphere/bee-dashboard ``` For the latest stable version, always use the official npm registry. ## Usage :warning: To successfully connect to the Bee node, you will need to enable CORS. You can do so by setting `cors-allowed-origins: ['*']` in the Bee config file and then restart the Bee node. To see where the config file is, consult the [official Bee documentation](https://docs.ethswarm.org/docs/working-with-bee/configuration#configuring-bee-installed-using-a-package-manager) ### Terminal To start use: ```sh bee-dashboard ``` This should open the webpage on [`http://localhost:8080`](http://localhost:8080) You can also define your own port with the `PORT` environment variable. E.g. ```sh export PORT=3005 bee-dashboard ``` Will start the bee-dashboard on [`http://localhost:3005`](http://localhost:3005) ### Docker To build Docker image and run it, execute the following from inside project directory: ```sh docker build . -t bee-dashboard docker run --rm -p 127.0.0.1:8080:8080 bee-dashboard ``` Alternatively, use Docker Compose: ```sh docker compose up ``` Bee dashboard is now available on [`http://localhost:8080`](http://localhost:8080) ### Development ```sh git clone git@github.com:ethersphere/bee-dashboard.git cd bee-dashboard pnpm install pnpm run init:husky pnpm start ``` The Bee Dashboard runs in development mode on [http://localhost:3002/](http://localhost:3002/) #### Environmental variables Vite supports specifying "environmental variables" during build time which are then hardcoded into the served static files. We support following variables: - `VITE_BEE_DESKTOP_ENABLED` (`boolean`) that toggles if the Dashboard is in Desktop mode or not. - `VITE_BEE_DESKTOP_URL` (`string`) defines custom URL where the Desktop API is expected. By default, it is same origin under which the Dashboard is served. - `VITE_BEE_HOST` (`string`) defines custom Bee API URL to be used as default one. By default, the `http://localhost:1633` is used. - `VITE_DEFAULT_RPC_URL` (`string`) defines the default RPC provider URL. Be aware, that his only configures the default value. The user can override this in Settings, which is then persisted in local store and has priority over the value set in this env. variable. By default `https://xdai.fairdatasociety.org` is used. - `VITE_FORMBRICKS_ENV_ID` and `VITE_FORMBRICKS_APP_URL` (`string`) configures the [Formbricks](https://formbricks.com/) integration for user feedback collection. If these variables are not set, the feedback form is not available in the app. #### Swarm Desktop development If you want to develop Bee Dashboard in the Swarm Desktop mode, then spin up `swarm-desktop` to the point where Desktop is initialized (eq. the splash screen disappear) and: ```sh echo "VITE_BEE_DESKTOP_URL=http://localhost:3054 VITE_BEE_DESKTOP_ENABLED=true" > .env.development.local pnpm start pnpm run desktop # This will inject the API key to the Dashboard ``` #### Mock Bee proxy To manually test error handling without breaking a real node, `utils/mock-bee-proxy.js` proxies all requests to a local Bee node (`http://localhost:1633`) and can override selected endpoints with failure responses: - `pnpm mock:bee` — base script; pass-through by default, configurable via env variables - `pnpm mock:bee:nofunds` — preset: `POST /stamps/*` fails with `400 "out of funds"` - `pnpm mock:bee:poor` — preset: `GET /wallet` reports near-zero xBZZ/xDAI balances The proxy listens on `http://localhost:11633` — point the dashboard's Bee API endpoint (Settings page) there. For cases not covered by the presets, set the env variables (`STATUS`, `MESSAGE`, `POOR_WALLET`, `PLUR`, `WEI`) directly: ```sh STATUS=507 MESSAGE='batch too large' pnpm mock:bee ``` ## File Manager The File Manager module provides intuitive decentralized file storage and management. For comprehensive documentation, see the [File Manager Documentation](./docs/FILE_MANAGER.md). ### Features - Create and manage multiple drives with configurable capacity and lifetime - Upload, download, and organize files with version control - Manage postage stamps required for file uploads - Configure erasure coding levels for data redundancy ## Contribute There are some ways you can make this module better: - Consult our [open issues](https://github.com/ethersphere/bee-dashboard/issues) and take on one of them - Help our tests reach 100% coverage! - Join us in our [Discord chat](https://discord.gg/wdghaQsGq5) in the #develop-on-swarm channel if you have questions or want to give feedback ## Maintainers - [Cafe137](https://github.com/Cafe137) See what "Maintainer" means [here](https://github.com/ethersphere/repo-maintainer). ## License [BSD-3-Clause](./LICENSE) [![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fethersphere%2Fbee-dashboard.svg?type=large)](https://app.fossa.com/projects/git%2Bgithub.com%2Fethersphere%2Fbee-dashboard?ref=badge_large) --- _Source: https://npm.io/package/@ethersphere/bee-dashboard · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._