Updating LNbits

Quick reference for updating LNbits across all installation methods.

WARNING

Always back up your data directory and .env before updating. Database migrations run automatically on startup but cannot be reversed.

Docker

cd lnbits
docker compose pull
docker compose up -d

uv

cd lnbits
git pull --rebase
uv sync --all-extras

Poetry

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

pip

pip install --upgrade lnbits

Nix

cd lnbits
git pull --rebase
nix build
# or re-enter the dev shell:
nix develop

For NixOS module users, update your flake input and rebuild:

nix flake update
sudo nixos-rebuild switch

AppImage / Desktop

Download the latest version from GitHub Releases and replace the old binary. Your data in data/ is preserved.

Fly.io

cd lnbits
git pull --rebase
fly deploy

Node platforms

Updates are handled through the platform's UI:

• Umbrel - App Store → LNbits → Update
• RaspiBlitz - Services menu → LNbits → Update
• Start9 - Marketplace → LNbits → Update
• Citadel - App Store → LNbits → Update
• myNode - Dashboard → Applications → LNbits → Update

After updating

Use Admin UI → Extensions → "Update All" to bring extensions up to the latest compatible versions.

Next steps

• Changelog - see what changed

Related Pages

• Installation Overview - all installation methods
• Docker - container-based deployment
• Install with uv - source-based installation