# lnSwitchboard

lnSwitchboard is a self-hosted Lightning Address switchboard that creates and manages LNURL-pay addresses, usernames, tags, and vanity handles directly on your own Lightning node. It is open source and self-hosted, installable on Docker Hub and Umbrel.

Canonical page: https://ourlocalhost.com/app/3561/lnswitchboard

## Description

lnSwitchboard is a self-hosted Lightning Address switchboard that creates and manages LNURL-pay addresses, usernames, tags, and vanity handles directly on your own Lightning node. It serves a public pay endpoint plus a local admin dashboard on port 22121, with built-in rate limiting, settlement tracking, inbound liquidity insights, and a per-request activity log. Aimed at self-hosters running a Bitcoin node who want their own custodial, command-line-free receiving addresses on their own domain.

## Platform availability

Available on 1 of 10 platforms: Umbrel.

## Health score

50/100 (Fair), based on 3 of 4 factors.
- Maintained: 88 (last commit 13 days ago)
- Popular: 0 (0 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Docker Hub: https://hub.docker.com/r/ryleastark/lnswitchboard
- Umbrel: https://apps.umbrel.com/app/lnswitchboard
- GitHub: https://github.com/RyleaStark/lnSwitchboard

## Common questions

### Which parts of lnSwitchboard should be exposed to the internet?

Only the public LNURL-pay endpoint should be exposed. The dashboard and admin routes stay local on port 22121.

### Do I need a domain and reverse proxy?

Yes, you need your own domain and a reverse proxy.

### Will standard Lightning wallets be able to pay it?

It is compatible with major LNURL-supporting wallets and services.

### Can I create multiple addresses, tags, or vanity handles from one backend?

Yes. It supports unlimited Lightning Addresses, usernames, tags, and vanity handles mapped to the same backend.

### Where are the setup instructions?

Open Help inside the app to access the wiki and getting-started guides.

### Does it include request logging and rate limiting?

It includes built-in rate limiting, real settlement tracking, inbound liquidity insights, and an activity log for every request.

---
Source: Our Local Host (https://ourlocalhost.com/app/3561/lnswitchboard), the self-hosted and open-source app directory.
