Lightning Shell

Your personal server's shell

Made with 🧡 by @ibz

See my other app: usocial

View the Project on GitHub ibz/lightning-shell



Lightning Shell

Lightning Shell is a shell for Bitcoin nodes / personal servers.

It is currently used on Umbrel and Citadel.

Technically it’s a Docker container with ttyd and additional utilities.

Included utilities

General Lightning node management

Fee management

Rebalancing tools

Market tools

Data tools



The easiest way to install Lightning Shell is from your node’s app store.

At the opposite end of the spectrum you could simply copy-paste parts of the Dockerfile to build only the tools you want without actually installing Lightning Shell.

There are countless other ways to make use of it in between the two extremes because after all you can fork the repo, customize the Dockerfile, build it and run it yourself.


Running any of the included utilities will just work without you having to tell them how to connect to LND.

How does this work?

Your personal server OS passes the LND_IP environment variable and mounts the lnd directory under /lnd when it launches the Lightning Shell Docker container.

There are some additional scripts in ~/.local/bin named the same as the included utilities, which take care of passing the necessary arguments to the respective utilities.