LNbits Docs

Appearance

Install with Poetry ​

Install LNbits from source using Poetry for Python dependency management.

Poetry is the traditional Python dependency manager used by LNbits.

Prerequisites ​

Install ​

bash
git clone https://github.com/lnbits/lnbits.git
cd lnbits

# Install dependencies
poetry install

# Copy config
cp .env.example .env

Run ​

bash
poetry run lnbits

LNbits is now running at http://localhost:5000.

Development mode ​

bash
poetry run lnbits --reload

Using pip instead ​

If you prefer pip over Poetry:

bash
pip install lnbits
lnbits

Updating ​

bash
cd lnbits
git pull --rebase
poetry install --only main

If you installed with pip:

bash
pip install --upgrade lnbits

After updating, use Admin UI → Extensions → "Update All" to update extensions.

Next steps ​