+
+When enabled, ngrok creates a tunnel to ngrok.io with https support and tells you the https web address where you can access your lnbits instance. If you are not the first user to enable it, it doesn't create a new one, it just tells you the existing one. Useful for creating/managing/using lnurls, which must be served either via https or via tor. Note that if you restart your device, your device will generate a new url. If anyone is using your old one for wallets, lnurls, etc., whatever they are doing will stop working.
+
+
Installation
+
+Check the Extensions page on your instance of lnbits. If you have copy of lnbits with ngrok as one of the built in extensions, click Enable -- that's the only thing you need to do to install it.
+
+If your copy of lnbits does not have ngrok as one of the built in extensions, stop lnbits, create go into your lnbits folder, and run this command: ./venv/bin/pip install pyngrok. Then go into the lnbits subdirectory and the extensions subdirectory within that. (So lnbits > lnbits > extensions.) Create a new subdirectory in there called freetunnel, download this repository as a zip file, and unzip it in the freetunnel directory. If your unzipper creates a new "freetunnel" subdirectory, take everything out of there and put it in the freetunnel directory you created. Then go back to the top level lnbits directory and run these commands:
+
+```
+./venv/bin/quart assets
+./venv/bin/quart migrate
+./venv/bin/hypercorn -k trio --bind 0.0.0.0:5000 'lnbits.app:create_app()'
+```
+
+
Optional: set up an ngrok.com account
+
+The default setup makes a tunnel on a random subdomain, and the session times out after 24h or a certain bandwith limit. You can set up an account at ngrok.com; a free plan removes the timeout, and a paid plan lets you choose a custom subdomain (or even use your own domain). For this, get an auth token from ngrok.com, and then set it up as `NGROK_AUTHTOKEN` environment variable on your `.env` file e.g., if your auth token is xxxx, add a line NGROK_AUTHTOKEN=xxxx.
diff --git a/lnbits/extensions/ngrok/__init__.py b/lnbits/extensions/ngrok/__init__.py
new file mode 100644
index 000000000..a60414a39
--- /dev/null
+++ b/lnbits/extensions/ngrok/__init__.py
@@ -0,0 +1,18 @@
+import asyncio
+from fastapi import APIRouter, FastAPI
+from fastapi.staticfiles import StaticFiles
+from starlette.routing import Mount
+from lnbits.db import Database
+from lnbits.helpers import template_renderer
+from lnbits.tasks import catch_everything_and_restart
+
+db = Database("ext_ngrok")
+
+ngrok_ext: APIRouter = APIRouter(prefix="/ngrok", tags=["ngrok"])
+
+
+def ngrok_renderer():
+ return template_renderer(["lnbits/extensions/ngrok/templates"])
+
+
+from .views import *
diff --git a/lnbits/extensions/ngrok/config.json b/lnbits/extensions/ngrok/config.json
new file mode 100644
index 000000000..58e9ff8e2
--- /dev/null
+++ b/lnbits/extensions/ngrok/config.json
@@ -0,0 +1,6 @@
+{
+ "name": "Ngrok",
+ "short_description": "Serve lnbits over https for free using ngrok",
+ "icon": "trip_origin",
+ "contributors": ["supertestnet"]
+}
diff --git a/lnbits/extensions/ngrok/migrations.py b/lnbits/extensions/ngrok/migrations.py
new file mode 100644
index 000000000..f9b8b37dc
--- /dev/null
+++ b/lnbits/extensions/ngrok/migrations.py
@@ -0,0 +1,11 @@
+# async def m001_initial(db):
+
+# await db.execute(
+# """
+# CREATE TABLE example.example (
+# id TEXT PRIMARY KEY,
+# wallet TEXT NOT NULL,
+# time TIMESTAMP NOT NULL DEFAULT """ + db.timestamp_now + """
+# );
+# """
+# )
diff --git a/lnbits/extensions/ngrok/templates/ngrok/index.html b/lnbits/extensions/ngrok/templates/ngrok/index.html
new file mode 100644
index 000000000..3af4fa44f
--- /dev/null
+++ b/lnbits/extensions/ngrok/templates/ngrok/index.html
@@ -0,0 +1,53 @@
+{% extends "base.html" %} {% from "macros.jinja" import window_vars with context
+%} {% block page %}
+
+
+
+
+
+
+ Access this lnbits instance at the following url
+
+ Note that if you restart your device, your device will generate a
+ new url. If anyone is using your old one for wallets, lnurls,
+ etc., whatever they are doing will stop working.
+
+
+