Revise LNBits Admin UI documentation (#3443)
This commit is contained in:
parent
691b7ad055
commit
b4eccb9e5d
5 changed files with 32 additions and 26 deletions
|
|
@ -18,7 +18,9 @@ nav_order: 1
|
||||||
|
|
||||||
# LNBits Admin UI
|
# LNBits Admin UI
|
||||||
|
|
||||||
We introduced the Admin UI as the new default to make setup simpler and more straightforward. Instead of hand editing the `.env` file, you configure key server settings directly in the frontend with clear labels and guardrails.
|
[What you can do](#what-you-can-do-with-the-admin-ui) · [First Run](#first-run-and-super-user-id) · [Enable/Disable](#enabling-or-disabling-the-admin-ui) · [Reset](#reset-to-defaults) · [Allowed Users](#allowed-users) · [Guides](#additional-guides)
|
||||||
|
|
||||||
|
**We introduced the Admin UI as the new default to make setup simpler and more straightforward**. Instead of hand editing the `.env` file, you configure key server settings directly in the frontend with clear labels and guardrails.
|
||||||
|
|
||||||
<ins>On a fresh install the Admin UI is enabled by default</ins>, and at first launch you are prompted to create **Super User** credentials so that sensitive operations, such as switching funding sources, remain in trusted hands. When the Admin UI is enabled, configuration is written to and read from the database; for all settings managed by the UI, the parameters in `.env` are largely no longer used. If you disable the Admin UI, the `.env` file becomes the single source of truth again.
|
<ins>On a fresh install the Admin UI is enabled by default</ins>, and at first launch you are prompted to create **Super User** credentials so that sensitive operations, such as switching funding sources, remain in trusted hands. When the Admin UI is enabled, configuration is written to and read from the database; for all settings managed by the UI, the parameters in `.env` are largely no longer used. If you disable the Admin UI, the `.env` file becomes the single source of truth again.
|
||||||
|
|
||||||
|
|
@ -42,6 +44,27 @@ For a complete reference of legacy variables consult **[.env.example](../../.env
|
||||||
> [!NOTE]
|
> [!NOTE]
|
||||||
> See **[Super User](./super_user.md)** for the role and permission differences compared to Admin Users.
|
> See **[Super User](./super_user.md)** for the role and permission differences compared to Admin Users.
|
||||||
|
|
||||||
|
## First run and Super User ID
|
||||||
|
|
||||||
|
On first start with the Admin UI enabled you will be prompted to generate a Super User.
|
||||||
|
|
||||||
|
<img width="1573" height="976" alt="Admin_UI_first_install" src="https://github.com/user-attachments/assets/05aa634f-06ec-4a4d-a5c6-d90927c90991" />
|
||||||
|
|
||||||
|
If you need to read it from disk later:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cat /lnbits/data/.super_user
|
||||||
|
# example
|
||||||
|
123de4bfdddddbbeb48c8bc8382fe123
|
||||||
|
```
|
||||||
|
|
||||||
|
> [!WARNING]
|
||||||
|
> For security reasons, Super Users and Admin users must authenticate with credentials (username and password).
|
||||||
|
|
||||||
|
After login you will see **Settings** and **Users** in the sidebar between **Wallets** and **Extensions**, plus a role badge in the top left.
|
||||||
|
|
||||||
|
<img width="1353" height="914" alt="grafik" src="https://github.com/user-attachments/assets/06bb4f36-a23a-4058-87ec-60440d322c25" />
|
||||||
|
|
||||||
## Enabling or disabling the Admin UI
|
## Enabling or disabling the Admin UI
|
||||||
|
|
||||||
The Admin UI is enabled by default on new installs. To change the state:
|
The Admin UI is enabled by default on new installs. To change the state:
|
||||||
|
|
@ -82,23 +105,6 @@ The Admin UI is enabled by default on new installs. To change the state:
|
||||||
|
|
||||||
Using `Reset to defaults` in the Admin UI wipes stored settings. After a restart, a new `Super User` is created and the old one is no longer valid.
|
Using `Reset to defaults` in the Admin UI wipes stored settings. After a restart, a new `Super User` is created and the old one is no longer valid.
|
||||||
|
|
||||||
## First run and Super User ID
|
|
||||||
|
|
||||||
On first start with the Admin UI enabled you will be prompted to generate a Super User. If you need to read it from disk later:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
cat /lnbits/data/.super_user
|
|
||||||
# example
|
|
||||||
123de4bfdddddbbeb48c8bc8382fe123
|
|
||||||
```
|
|
||||||
|
|
||||||
> [!WARNING]
|
|
||||||
> For security reasons, Super Users and Admin users must authenticate with credentials (username and password).
|
|
||||||
|
|
||||||
After login you will see **Settings** and **Users** in the sidebar between **Wallets** and **Extensions**, plus a role badge in the top left.
|
|
||||||
|
|
||||||
<img width="1353" height="914" alt="grafik" src="https://github.com/user-attachments/assets/06bb4f36-a23a-4058-87ec-60440d322c25" />
|
|
||||||
|
|
||||||
## Allowed Users
|
## Allowed Users
|
||||||
|
|
||||||
When set **at least one**, LNbits becomes private: only the listed users and Admins can access the frontend. Account creation is disabled automatically. You can also disable account creation explicitly.
|
When set **at least one**, LNbits becomes private: only the listed users and Admins can access the frontend. Account creation is disabled automatically. You can also disable account creation explicitly.
|
||||||
|
|
@ -111,8 +117,8 @@ When set **at least one**, LNbits becomes private: only the listed users and Adm
|
||||||
## Additional Guides
|
## Additional Guides
|
||||||
|
|
||||||
- **[Backend Wallets](./wallets.md)** — Explore options to fund your LNbits instance.
|
- **[Backend Wallets](./wallets.md)** — Explore options to fund your LNbits instance.
|
||||||
- **[User Roles](./User_Roles.md)** — Overview of existing roles in LNbits.
|
- **[User Roles](./user_roles.md)** — Overview of existing roles in LNbits.
|
||||||
- **[Funding sources](./funding-sources_table.md)** — What is available and how to configure each.
|
- **[Funding sources](./funding-sources-table.md)** — What is available and how to configure each.
|
||||||
- **[Install LNBits](./installation.md)** — Choose your prefared way to install LNBits.
|
- **[Install LNBits](./installation.md)** — Choose your prefared way to install LNBits.
|
||||||
|
|
||||||
## Powered by LNbits
|
## Powered by LNbits
|
||||||
|
|
|
||||||
|
|
@ -116,8 +116,8 @@ These are practical tips for running a safe and friendly instance.
|
||||||
## Additional guides
|
## Additional guides
|
||||||
|
|
||||||
- **[Admin UI](./admin_ui.md)** — Manage server settings in the browser instead of editing `.env` or using the CLI for routine tasks.
|
- **[Admin UI](./admin_ui.md)** — Manage server settings in the browser instead of editing `.env` or using the CLI for routine tasks.
|
||||||
- **[User Roles](./User_Roles.md)** — Overview of roles and what they can do.
|
- **[User Roles](./user_roles.md)** — Overview of roles and what they can do.
|
||||||
- **[Funding sources](./funding-sources_table.md)** — Available options and how to enable and configure them.
|
- **[Funding sources](./funding-sources-table.md)** — Available options and how to enable and configure them.
|
||||||
- **[Install LNBits](./installation.md)** — Choose your prefared way to install LNBits.
|
- **[Install LNBits](./installation.md)** — Choose your prefared way to install LNBits.
|
||||||
|
|
||||||
## Powered by LNbits
|
## Powered by LNbits
|
||||||
|
|
|
||||||
|
|
@ -87,7 +87,7 @@ For using LNbits, not administering it.
|
||||||
|
|
||||||
- **[Admin UI](./admin_ui.md)** — Manage server settings via a clean UI (avoid editing `.env` by hand).
|
- **[Admin UI](./admin_ui.md)** — Manage server settings via a clean UI (avoid editing `.env` by hand).
|
||||||
- **[Super User](./super_user.md)** — Deep dive on responsibilities and safe usage patterns.
|
- **[Super User](./super_user.md)** — Deep dive on responsibilities and safe usage patterns.
|
||||||
- **[Funding sources](./funding-sources_table.md)** — What’s available and how to enable/configure each.
|
- **[Funding sources](./funding-sources-table.md)** — What’s available and how to enable/configure each.
|
||||||
|
|
||||||
## Powered by LNbits
|
## Powered by LNbits
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -354,8 +354,8 @@ Get more info here [https://docs.strike.me/strike-oauth-connect/](https://docs.s
|
||||||
## Additional Guides
|
## Additional Guides
|
||||||
|
|
||||||
- **[Admin UI](./admin_ui.md)** — Manage server settings via a clean UI (avoid editing `.env` by hand).
|
- **[Admin UI](./admin_ui.md)** — Manage server settings via a clean UI (avoid editing `.env` by hand).
|
||||||
- **[User Roles](./User_Roles.md)** — Quick Overview of existing Roles in LNBits.
|
- **[User Roles](./user_roles.md)** — Quick Overview of existing Roles in LNBits.
|
||||||
- **[Funding sources](./funding-sources_table.md)** — What’s available and how to enable/configure each.
|
- **[Funding sources](./funding-sources-table.md)** — What’s available and how to enable/configure each.
|
||||||
|
|
||||||
## Powered by LNbits
|
## Powered by LNbits
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -23,10 +23,10 @@
|
||||||
"axios": "^1.12.0",
|
"axios": "^1.12.0",
|
||||||
"chart.js": "^4.4.4",
|
"chart.js": "^4.4.4",
|
||||||
"moment": "^2.30.1",
|
"moment": "^2.30.1",
|
||||||
|
"nostr-tools": "^2.7.2",
|
||||||
"qrcode.vue": "^3.4.1",
|
"qrcode.vue": "^3.4.1",
|
||||||
"quasar": "2.17.0",
|
"quasar": "2.17.0",
|
||||||
"showdown": "^2.1.0",
|
"showdown": "^2.1.0",
|
||||||
"nostr-tools": "^2.7.2",
|
|
||||||
"underscore": "^1.13.7",
|
"underscore": "^1.13.7",
|
||||||
"vue": "3.5.8",
|
"vue": "3.5.8",
|
||||||
"vue-i18n": "^10.0.8",
|
"vue-i18n": "^10.0.8",
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue