Install with Poetry
Install LNbits from source using Poetry for Python dependency management.
Poetry is the traditional Python dependency manager used by LNbits.
Prerequisites
- Python 3.10+
- Poetry
- Git
Install
bash
git clone https://github.com/lnbits/lnbits.git
cd lnbits
# Install dependencies
poetry install
# Copy config
cp .env.example .envRun
bash
poetry run lnbitsLNbits is now running at http://localhost:5000.
Development mode
bash
poetry run lnbits --reloadUsing pip instead
If you prefer pip over Poetry:
bash
pip install lnbits
lnbitsUpdating
bash
cd lnbits
git pull --rebase
poetry install --only mainIf you installed with pip:
bash
pip install --upgrade lnbitsAfter updating, use Admin UI → Extensions → "Update All" to update extensions.
Next steps
- Configuration - customize your instance
- Funding sources - connect a Lightning backend
- Reverse proxy - set up HTTPS
Related Pages
- Installation Overview - all installation methods
- Install with uv - faster alternative source install
- Updating LNbits - keep LNbits up to date