lnbits-legend/docs/devs/installation.md
Tiago Vasconcelos 2e8145faac
Documentation Updates (#202)
Updates for user manager and subdomains extensions

Co-authored-by: Tiago Vasconcelos <tvasconcelos@gmail.com>
2021-06-09 12:07:42 -03:00

1.7 KiB

layout parent title nav_order
default For developers Installation 1

Installation

Download the latest stable release https://github.com/lnbits/lnbits/releases

Application dependencies

The application uses Pipenv to manage Python packages. While in development, you will need to install all dependencies:

$ pipenv shell
$ pipenv install --dev

If any of the modules fails to install, try checking and upgrading your setupTool module.
pip install -U setuptools

If you wish to use a version of Python higher than 3.7:

$ pipenv --python 3.8 install --dev

You will need to copy .env.example to .env, then set variables there.

Files

You might also need to install additional packages, depending on the backend wallet you use. E.g. when you want to use LND you have to pipenv run pip install lndgrpc and pipenv run pip install purerpc.

Take a look at Polar for an excellent way of spinning up a Lightning Network dev environment.

Running the server

LNbits uses Quart as an application server.

$ pipenv run python -m lnbits

Note: You'll need to use https for some endpoints and/or extensions. You can use ngrok for that. Follow the installation instructions on the website and when it's all set you can run:

$ ./nrok http 5000

this will give you an https tunnel for the localhost, use that URL for navigating to LNBits.

Frontend

The frontend uses Vue.js and Quasar.