Practical overview
When it fits
Use Cashu.me when a Cashu wallet is needed for browser-based ecash management, Lightning payments, multi-mint payments or a self-hosted deployment.
Who it is for
- Cashu users managing ecash through a web or installable wallet
- Developers building or self-hosting a Cashu wallet interface
- Bitcoin users working with Cashu mints and Lightning payments
Documented uses
- Send, receive, create, scan and redeem Cashu ecash tokens
- Pay and create BOLT11 invoices and use BOLT12 offers
- Deposit and withdraw on-chain bitcoin where supported by a mint
- Manage funds across multiple Cashu mints
- Back up or restore wallet state with a 12-word seed phrase
Requirements & limits
The repository describes Cashu.me as free and open-source under the MIT license. It is documented for web/PWA use, Android and iOS through Capacitor, desktop through Electron, and browser-extension packaging. Local development requires Node.js >= 22.4 and npm.
- Wallet keys and tokens are stored locally in browser IndexedDB, according to the project README.
- On-chain deposits and withdrawals depend on support from the connected mint.
- The application can connect to multiple mints and supports NUT-15 multinut payments.
- Self-hosting requires Docker for the documented quick start; reverse-proxy hosting needs SPA fallback and service-worker headers.
- The repository is TypeScript-based and provides Vitest, Playwright, ESLint and Prettier commands for development workflows.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Self-host Cashu.me with Docker
Start a local Cashu.me wallet instance from the public repository.
Before you start
- Git
- Docker and Docker Compose
Steps
Clone the cashubtc/cashu.me repository.
Change into the repository directory.
Run docker compose up -d.
Open the wallet at http://localhost:3000, or place it behind a reverse proxy using the project’s self-hosting guidance.
Expected outcome
A self-hosted Cashu.me wallet is made available locally on port 3000.
Guide limitations
- The documented quick start does not describe mint configuration, wallet funding or transaction execution.
- A reverse-proxy deployment requires a history-mode fallback to index.html and appropriate service-worker headers.
Prepare Cashu.me for local development
Install the project dependencies and start its development server.
Before you start
- Node.js >= 22.4
- npm
Steps
Clone the cashubtc/cashu.me repository and change into its directory.
Run npm install.
Run npm run dev to start the development server.
Expected outcome
A local Cashu.me development instance is started with hot reloading.
Guide limitations
- This recipe covers development setup only; it does not document production deployment or a completed payment flow.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 3 October 2026
- Original website title
- cashubtc/cashu.me · Official homepage title · retained in its source language

