Merge remote-tracking branch 'origin/FastAPI' into FastAPI

This commit is contained in:
Ben Arc
2021-11-09 23:59:30 +00:00
2 changed files with 15 additions and 19 deletions

View File

@@ -14,19 +14,18 @@ Download the latest stable release https://github.com/lnbits/lnbits/releases
The application uses [Pipenv][pipenv] to manage Python packages. The application uses [Pipenv][pipenv] to manage Python packages.
While in development, you will need to install all dependencies: While in development, you will need to install all dependencies:
```sh git clone https://github.com/lnbits/lnbits-legend.git
$ pipenv shell cd lnbits-legend/
$ pipenv install --dev # for now you'll need to `git checkout FastAPI`
``` pipenv shell
pipenv install --dev
If any of the modules fails to install, try checking and upgrading your setupTool module. If any of the modules fails to install, try checking and upgrading your setupTool module.
`pip install -U setuptools` `pip install -U setuptools`
If you wish to use a version of Python higher than 3.7: If you wish to use a version of Python higher than 3.7:
```sh pipenv --python 3.8 install --dev
$ pipenv --python 3.8 install --dev
```
You will need to copy `.env.example` to `.env`, then set variables there. You will need to copy `.env.example` to `.env`, then set variables there.
@@ -39,24 +38,20 @@ Take a look at [Polar][polar] for an excellent way of spinning up a Lightning Ne
## Running the server ## Running the server
LNbits uses [Quart][quart] as an application server. LNbits uses [FastAPI][fastapi] as an application server.
Before running the server for the first time, make sure to create the data folder: Before running the server for the first time, make sure to create the data folder and edit the .env file:
```sh mkdir data
$ mkdir data cp .env.example .env
``` sudo nano .env
To then run the server, use: To then run the server, use:
```sh pipenv run python -m uvicorn lnbits.__main__:app --reload
$ pipenv run python -m lnbits
```
**Note**: You'll need to use _https_ for some endpoints and/or extensions. You can use [ngrok](https://ngrok.com/) for that. Follow the installation instructions on the website and when it's all set you can run: **Note**: You'll need to use _https_ for some endpoints and/or extensions. You can use [ngrok](https://ngrok.com/) for that. Follow the installation instructions on the website and when it's all set you can run:
```sh ./nrok http 5000
$ ./nrok http 5000
```
this will give you an _https_ tunnel for the _localhost_, use that URL for navigating to LNBits. this will give you an _https_ tunnel for the _localhost_, use that URL for navigating to LNBits.

View File

@@ -9,9 +9,10 @@ nav_order: 2
Download this repo and install the dependencies: Download this repo and install the dependencies:
```sh ```sh
git clone https://github.com/lnbits/lnbits.git git clone https://github.com/lnbits/lnbits-legend.git
cd lnbits/ cd lnbits/
# ensure you have virtualenv installed, on debian/ubuntu 'apt install python3-venv' should work # ensure you have virtualenv installed, on debian/ubuntu 'apt install python3-venv' should work
# for now you'll need to `git checkout FastAPI`
python3 -m venv venv python3 -m venv venv
./venv/bin/pip install -r requirements.txt ./venv/bin/pip install -r requirements.txt
cp .env.example .env cp .env.example .env