</a>

LNbits Roles: A Quick Overview

Understand who can do what in seconds: Super User, Admin, and Regular User.

Jump to:
Roles at a Glance • Super User • Admin • Regular User • Best Practices • Additional Guides

---

Roles at a Glance

Capability	Super User (owner)	Admin (manager)	Regular User (end user)
Change funding source	✅	❌	❌
Credit/Debit any wallet	✅	❌	❌
Manage Admins & Users	✅	✅	❌
Enable/disable extensions	✅	✅	❌
Use wallets & allowed extensions	✅	✅	✅

Plain talk: Super User = Owner • Admin = Trusted manager • Regular User = End user

Role Snapshots

Super User — Master Control

For initial setup and rare, high-impact changes.

• Configure server-level settings (e.g., funding source).
• Credit/Debit any wallet.
• Create and manage initial Admin(s).

Sign-in: username + password (v1+). The old query-string login is retired.

Admin — Day-to-Day Manager

For running the service without touching the most sensitive knobs.

• Manage Users, Admins, and Extensions in the Admin UI.
• Adjust security-related settings (e.g., rate_limiter, ip_blocker).
• Handle operations settings (e.g., service_fee, invoice_expiry).
• Build brand design in Site Customization.
• Update user accounts.

Typical tasks: onboarding users, enabling extensions, tidying wallets, reviewing activity.

Sign-in: username + password (v1+). The old query-string login is retired.

Regular User — Everyday Use

For using LNbits, not administering it.

• Access personal wallets and allowed extensions.
• No server/admin privileges.

Typical tasks: receive and send payments, use enabled extensions.

Best Practices

• Minimize risk: Reserve Super User for rare, sensitive actions (funding source, debit/credit). Use Admin for daily operations.
• Keep access tidy: Review your Admin list occasionally; remove unused accounts.
• Change management: Test risky changes (like funding) in a staging setup first.

Additional Guides

• Admin UI — Manage server settings via a clean UI (avoid editing .env by hand).
• Super User — Deep dive on responsibilities and safe usage patterns.
• Funding sources — What’s available and how to enable/configure each.

Powered by LNbits

LNbits empowers everyone with modular, open-source tools for building Bitcoin-based systems—fast, free, and extendable.

If you like this project, send some tip love or visit our Shop