Difference between revisions of "Main Page"

From PlebNet Wiki
Jump to navigation Jump to search
(Moved FAQ down, because the mainpage otherwise is in a good order for noobs to start from top to bottom. FAQ contains a few advanced topics, shouldn't be before "welcome" section or "getting started" section)
 
(34 intermediate revisions by 8 users not shown)
Line 1: Line 1:
= PLEBNET for plebs =
<languages/>
<translate>
<!--T:2-->
'''Welcome to PLEBNET!'''


Welcome to the Plebnet! We've outlined the main 'guide' on this page. Follow the articles here in order to gain a better understanding of the steps required to join the PlebNet, and getting your node up & running. If you'd like to simply browse around, you can view all our pages [[Special:AllPages]].
<!--T:53-->
We've outlined the main 'guide' on this page. Follow the articles here in order to gain a better understanding of the steps required to join PLEBNET, and getting your node up & running. If you'd like to simply browse around, you can view all our pages [[Special:AllPages|Special:AllPages]].


== Welcome to Plebnet ==


[[Welcome to Plebnet]]
== To read first == <!--T:3-->


'''Please read the above link before anything else!''' Contains useful introduction and tips.
<!--T:4-->
[[Special:MyLanguage/Welcome to Plebnet|Welcome to PLEBNET]]


== Getting Started ==
<!--T:5-->
'''Please read the above link before anything else!''' Contains a useful introduction and tips.


Are you brand new and perhaps don't quite understand lightning? Do you not have your own node yet? Are you not yet in the Plebnet telegram group?
[[Notes on Privacy | Important points to consider on how to protect your privacy]]


Please see the [[Getting started]] page.
== Getting Started == <!--T:6-->


== Claim your node ==
<!--T:7-->
Are you brand new and perhaps don't quite understand lightning? Do you not have your own node yet? Are you not yet in the PLEBNET telegram group?
 
<!--T:8-->
Please see the [[Special:MyLanguage/Getting started|Getting started]] page.
 
 
== Claim your node [optional]== <!--T:9-->
 
Important: If you are concerned about your privacy, do not claim your node (or for that matter use telegram). There are a few things to be aware of when claiming your node on cheeserobot. CheeseRobot, a closed source software, will link your telegram handle to your node, and subsequently to UTXOs (or bitcoin public addresses) for any public channels that you establish. This may have unintended consequences of doxing your identify (and UTXOs) in case the phone number that is associated with your telegram handle is exposed. Make sure to take basic precautions if you do opt to use the cheeserobot, like making sure that your telegram phone number isn't visible by default and isn't exposed to your contacts.
 
<!--T:10-->
For telegram, DM [https://t.me/cheeserobot @cheeserobot] and then <code>/claim</code> your node (follow the instructions, you will need to sign a message with your node to prove you are owner of the node).
For telegram, DM [https://t.me/cheeserobot @cheeserobot] and then <code>/claim</code> your node (follow the instructions, you will need to sign a message with your node to prove you are owner of the node).


Then, in the [https://t.me/plebnet plebnet] group announce your node with <code>/node</code>. If you see your own node, success.
<!--T:11-->
Then, in the [https://t.me/plebnet PLEBNET] group announce your node with <code>/node</code>. If you see your own node, success.
Repeat in other groups which support CheeseRobot with <code>/node</code>.
Repeat in other groups which support CheeseRobot with <code>/node</code>.


Additionally, [https://amboss.space Amboss.space] is one of the best websites for looking up nodes and their basic information. People may go to Amboss to browse your node's info. You can claim your node on Amboss which will allow you personalize your node's profile and add additional information. Use these instructions: [[Claim on Amboss]]
<!--T:12-->
Additionally, [https://amboss.space Amboss.space] is one of the best websites for looking up nodes and their basic information. People may go to Amboss to browse your node's info. You can claim your node on Amboss which will allow you personalize your node's profile and add additional information. Use these instructions: [[Special:MyLanguage/Claim on Amboss|Claim on Amboss]]


== Opening Channels ==
== Opening Channels == <!--T:13-->


<!--T:14-->
The first question which a pleb has after (or even before) the node is synced "'''who should I open channel with'''"
The first question which a pleb has after (or even before) the node is synced "'''who should I open channel with'''"


<!--T:15-->
I would say - '''with a mentor who is willing to spend time with you, teach you the ropes, mentor and guide you to be a better node runner'''
I would say - '''with a mentor who is willing to spend time with you, teach you the ropes, mentor and guide you to be a better node runner'''


<!--T:16-->
Of course in the age of google, internet, and instant gratification, this thought can be frowned upon but there is no replacement for a mentor in your journey as node runner.
Of course in the age of google, internet, and instant gratification, this thought can be frowned upon but there is no replacement for a mentor in your journey as node runner.


For information relating to lightning channels, including methods to get inbound liquidity see: [[Opening channels]]
<!--T:17-->
For information relating to lightning channels, including methods to get inbound liquidity see: [[Special:MyLanguage/Opening channels|Opening channels]]
 
== Rebalance Channels ==
 
Keeping your channels properly balanced is critical to your node's routing ability. Ride The Lightning and Thunderhub are good visual tools to start with. As you progress in your journey, the [https://github.com/alexbosworth/balanceofsatoshis Balance of Satoshis] is a command-line tool that provides extra flexibility to rebalance your peers. [https://github.com/itsneski/lightning-jet Lightning Jet] is a fully automated rebalancer that will automatically rebalance all of your channels. See [[Resources]] for links to other available tools.
 
== Maintaining Proper Node Hygiene == <!--T:18-->
 
<!--T:21-->
[[Special:MyLanguage/Node Hardening|Node Hardening]]


== Maintaining Proper Node Hygiene ==
<!--T:19-->
[[Special:MyLanguage/Maintaining node hygiene|Maintaining node hygiene]]


[[Maintaining node hygiene]]
<!--T:20-->
[[Special:MyLanguage/Node Hardware|Node Hardware]]


[[Node Hardware]]
<!--T:22-->
[[Special:MyLanguage/UPS|UPS]] (Uninterrupted Power Supply)


[[Node Hardening]]
[[Reduce_channel_database_size | Keeping Channel DB in check ]]


[[UPS]] (Uninterrupted Power Supply)
[[Compacting_Channel_DB | Prune and compact channel DB ]]


== Backup/Recovery ==
== Backup/Recovery == <!--T:23-->


<!--T:24-->
The following link contains some important information about channel backups and recovery solutions so that you have a better idea of how to keep your funds safe.
The following link contains some important information about channel backups and recovery solutions so that you have a better idea of how to keep your funds safe.


[[Backup/Recovery]]
<!--T:25-->
[[Special:MyLanguage/Backup/Recovery|Backup/Recovery]]
 


== Let’s Get Personal ==
== Let’s Get Personal == <!--T:26-->


<!--T:27-->
Your node can be customized to appear as a name (alias) rather than just a bunch of random letters and numbers. You can also set a color for your node that will show up on various lightning-related websites and programs.  
Your node can be customized to appear as a name (alias) rather than just a bunch of random letters and numbers. You can also set a color for your node that will show up on various lightning-related websites and programs.  


[[Setting a node alias]]
<!--T:28-->
[[Special:MyLanguage/Setting a node alias|Setting a node alias]]
 
 
== Upgrades == <!--T:29-->
 
<!--T:30-->
[[Special:MyLanguage/Upgrading Umbrel Node|Upgrading Umbrel Node]]
 
 
 
 
 
 
== Popular Tools == <!--T:31-->


== Upgrades ==
=== Balance of Satoshis === <!--T:33-->


[[Upgrading Umbrel Node]]
<!--T:35-->
Balance of Satoshis, or BoS, is a set of commands for working with LND balances. It can do similar things as interfaces like ThunderHub or Ride the Lightning. However, your options are much wider with BoS, and you will need it if you want to set up a telegram bot with your node (to get notifications whenever channels are opened/closed, whenever you forward a payment, whenever your node goes offline, and to get automatic channel backups for safety).


== Balance of Satoshis ==
<!--T:37-->
For more information, and common BoS commands see: [[Special:MyLanguage/Balance of Satoshis|Balance of Satoshis]].


Balance of Satoshis, or BoS, is a set of commands for working with LND balances. It can do similar things as interfaces like ThunderHub or RideTheLightning. However, your options are much wider with BoS, and you will need it if you want to set up a telegram bot with your node (to get notifications whenever channels are opened/closed, whenever you forward a payment, whenever your node goes offline, and to get automatic channel backups for security).
<!--T:52-->
[https://github.com/niteshbalusu11/BOS-Commands-Document See this excellent documentation for bos commands]


For more information, and common BoS commands see: [[Balance of Satoshis]].
<!--T:34-->
Installation: process for [[Special:MyLanguage/Umbrel - Installing BoS|Umbrel - Installing BoS]]. Includes instructions for setting up BoS telegram bot.


Installation: process for [[Umbrel - Installing BoS]]. Includes instructions for setting up BoS telegram bot.
=== Lightning Shell === <!--T:34-->
[https://lightningshell.app/ Lightning Shell] Lightning Shell is a shell for Bitcoin nodes / personal servers. Technically it’s a Docker container with ttyd and additional utilities.


== LND Configuration Settings Overview ==
It can be installed [https://github.com/ibz/lightning-shell manually] or via the Umbrel/Citadel app stores


Click the link below for information related to setting up channel size limits, predefined fees on new channels, setting up watchtowers, and other optimization settings.
Lightning shell includes many useful tools and saves you a lot of time installing them:


[[LND Configuration Settings]]
[[Special:MyLanguage/Umbrel - Installing BoS|Balance of Satoshis]]


== Running A Profitable Routing Node ==
[https://github.com/edouardparis/lntop lntop]


The profitability of a routing node is like for any business - revenue minus costs.  Revenue consists of fees that your node collects when routing transactions.  Costs consist of channel close/open fees, costs to move sats to your node, channel rebalance costs, and loop in/outs. Therefore, your node is profitable as long as revenue minus costs is positive.  Tracking [https://t.me/plebnet/40471 nodes's p&l] on a weekly basis may give you a good idea of how your node is progressing towards profitability. It is important to have [https://t.me/plebnet/81578 KPIs] for your node which you can measure before you can improve it.
lncli


Profitability is an important objective to keep in mind, but it takes time to get there. So when beginning your Lightning journey, it's essential to keep an open mind and be prepared to learn.  There is no right or wrong way to develop your node, so it comes down to the strategy that you opt to follow.  [https://youtu.be/LRZy-VtCPe4 Allocate your capital strategically] and be mindful of the costs (channel open/close, rebalancing, etc) and they do add up.
[[Special:MyLanguage/Suez| Suez]]


We talk about channel girth (size in sats) quite a bit, but the quality of [https://bitcoinmagazine.com/.amp/culture/four-tips-run-profitable-lightning-node your peer is more important than girth].  In other words, you can have a very liquid 2mil sats channel and an illiquid 10mil channel.  With that being said, a girthier channel to a quality peer is better.


A quality peer is a well-maintained active node that can help you get more traffic.  One metric that you can look at when selecting a peer is [https://medium.com/@jungly/measuring-node-centrality-in-lightning-network-8102a59999f0 centrality] - how close your node is to the center of the graph as opposed to being on the outside. In addition, here are some of the tools that can help optimize your node's centrality: [https://lnnodeinsight.com/ lnnodeinsight] - has a channel simulator to test centrality before establishing a channel with a node; [http://gridflare.xyz gridflare] - provides node recommendations to improve centrality.
== LND Configuration Settings Overview == <!--T:35-->


Your node will have a mix of channels of different sizes.  In general, it does not make sense to keep liquidity in channels with inactive peers.  You'd want to re-allocate your inactive liquidity either through circular rebalancing or through closing inactive channels and utilizing the freed-up liquidity elsewhere.  You will incur fees either way, so it comes down to weighing pros/cost of the options.  Based on our experience, mixing small channels with big channels does not impact a node's routing ability.
<!--T:36-->
Click the link below for information related to setting up channel size limits, predefined fees on new channels, setting up watchtowers, and other optimization settings.


[https://terminal.lightning.engineering/ Terminal Web] classifies nodes into good and pending and assigns a score. Based on our experience, the score does not materially affect routing, even though it helps attract other nodes to connect to yours (sort of like a marketing tool). You can use the [https://lnrouter.app/scores/terminal Terminal Score Debugger] tool to debug and optimize your node's score.
<!--T:37-->
[[Special:MyLanguage/LND Configuration Settings|LND Configuration Settings]]


[https://plebnet.wiki/wiki/Umbrel_-_Installing_BoS Balance of Satoshis] is an excellent tool to help you optimize channel rebalancing. It'll show you routing hops along with fees for each hop.  You can then further optimize rebalancing cost by excluding expensive nodes.


The following section discuss strategies and options you have available to run a profitable routing node.
== Running A Profitable Routing Node == <!--T:38-->


<!--T:39-->
Not seeing routing through your node, or your sats are only moving in one direction?


[[Fees And Profitability]] (Includes instructions for automatically-adjusting fees, and automatic KPI script!)
<!--T:40-->
Want more information about rebalancing and fees? Want to run a program that auto-adjusts your fees, or one that gives you KPIs (Key Performance Indicators)?


[[Balancing Nodes]]
<!--T:41-->
'''Your one stop shop for tips on routing node profitability:''' [[Special:MyLanguage/Running A Profitable Routing Node|Running A Profitable Routing Node]]


[[Help! I do not see any routing through my node]]
<!--T:42-->
[[Special:MyLanguage/Fees And Profitability|Shortcut to auto-fee and auto-KPI instructions]]


[[Help! My sats are only moving in one direction]]


== Playground / Sandbox ==
== Playground / Sandbox == <!--T:43-->


Click the image below to get information on Plebnet Playground, a place where you can learn and use the lightning network without risking any real money (signet).
<!--T:44-->
Click the image below to get information on PLEBNET Playground, a place where you can learn and use the lightning network without risking any real money (signet).


<!--T:45-->
[[File:PlebnetPlayground.jpg|450px|link=Plebnet Playground|alt=Plebnet Playground Logo]]
[[File:PlebnetPlayground.jpg|450px|link=Plebnet Playground|alt=Plebnet Playground Logo]]


== FAQ ==
A selection of questions frequently asked in [https://t.me/plebnet plebnet] groups.
[[FAQ]]


== Resources ==
== FAQ == <!--T:46-->
 
<!--T:47-->
A selection of questions frequently asked in [https://t.me/plebnet PLEBNET] groups.
[[Special:MyLanguage/FAQ|FAQ]]
 
 
== Resources == <!--T:48-->


[[Resources]]
<!--T:49-->
[[Special:MyLanguage/Resources|Resources]]


= All Pages =
= All Pages = <!--T:50-->








</translate>
{{:Special:Allpages}}
{{:Special:Allpages}}
<translate>
</translate>

Latest revision as of 16:59, 6 October 2022

Other languages:
English • ‎Hausa • ‎Türkçe • ‎Wolof • ‎Yorùbá • ‎español • ‎français • ‎العربية • ‎हिन्दी

Welcome to PLEBNET!

We've outlined the main 'guide' on this page. Follow the articles here in order to gain a better understanding of the steps required to join PLEBNET, and getting your node up & running. If you'd like to simply browse around, you can view all our pages Special:AllPages.


To read first

Welcome to PLEBNET

Please read the above link before anything else! Contains a useful introduction and tips.

Important points to consider on how to protect your privacy

Getting Started

Are you brand new and perhaps don't quite understand lightning? Do you not have your own node yet? Are you not yet in the PLEBNET telegram group?

Please see the Getting started page.


Claim your node [optional]

Important: If you are concerned about your privacy, do not claim your node (or for that matter use telegram). There are a few things to be aware of when claiming your node on cheeserobot. CheeseRobot, a closed source software, will link your telegram handle to your node, and subsequently to UTXOs (or bitcoin public addresses) for any public channels that you establish. This may have unintended consequences of doxing your identify (and UTXOs) in case the phone number that is associated with your telegram handle is exposed. Make sure to take basic precautions if you do opt to use the cheeserobot, like making sure that your telegram phone number isn't visible by default and isn't exposed to your contacts.

For telegram, DM @cheeserobot and then /claim your node (follow the instructions, you will need to sign a message with your node to prove you are owner of the node).

Then, in the PLEBNET group announce your node with /node. If you see your own node, success. Repeat in other groups which support CheeseRobot with /node.

Additionally, Amboss.space is one of the best websites for looking up nodes and their basic information. People may go to Amboss to browse your node's info. You can claim your node on Amboss which will allow you personalize your node's profile and add additional information. Use these instructions: Claim on Amboss

Opening Channels

The first question which a pleb has after (or even before) the node is synced "who should I open channel with"

I would say - with a mentor who is willing to spend time with you, teach you the ropes, mentor and guide you to be a better node runner

Of course in the age of google, internet, and instant gratification, this thought can be frowned upon but there is no replacement for a mentor in your journey as node runner.

For information relating to lightning channels, including methods to get inbound liquidity see: Opening channels

Rebalance Channels

Keeping your channels properly balanced is critical to your node's routing ability. Ride The Lightning and Thunderhub are good visual tools to start with. As you progress in your journey, the Balance of Satoshis is a command-line tool that provides extra flexibility to rebalance your peers. Lightning Jet is a fully automated rebalancer that will automatically rebalance all of your channels. See Resources for links to other available tools.

Maintaining Proper Node Hygiene

Node Hardening

Maintaining node hygiene

Node Hardware

UPS (Uninterrupted Power Supply)

Keeping Channel DB in check

Prune and compact channel DB

Backup/Recovery

The following link contains some important information about channel backups and recovery solutions so that you have a better idea of how to keep your funds safe.

Backup/Recovery


Let’s Get Personal

Your node can be customized to appear as a name (alias) rather than just a bunch of random letters and numbers. You can also set a color for your node that will show up on various lightning-related websites and programs.

Setting a node alias


Upgrades

Upgrading Umbrel Node




Popular Tools

Balance of Satoshis

Balance of Satoshis, or BoS, is a set of commands for working with LND balances. It can do similar things as interfaces like ThunderHub or Ride the Lightning. However, your options are much wider with BoS, and you will need it if you want to set up a telegram bot with your node (to get notifications whenever channels are opened/closed, whenever you forward a payment, whenever your node goes offline, and to get automatic channel backups for safety).

For more information, and common BoS commands see: Balance of Satoshis.

See this excellent documentation for bos commands

Installation: process for Umbrel - Installing BoS. Includes instructions for setting up BoS telegram bot.

Lightning Shell

Lightning Shell Lightning Shell is a shell for Bitcoin nodes / personal servers. Technically it’s a Docker container with ttyd and additional utilities.

It can be installed manually or via the Umbrel/Citadel app stores

Lightning shell includes many useful tools and saves you a lot of time installing them:

Balance of Satoshis

lntop

lncli

Suez


LND Configuration Settings Overview

Click the link below for information related to setting up channel size limits, predefined fees on new channels, setting up watchtowers, and other optimization settings.

LND Configuration Settings


Running A Profitable Routing Node

Not seeing routing through your node, or your sats are only moving in one direction?

Want more information about rebalancing and fees? Want to run a program that auto-adjusts your fees, or one that gives you KPIs (Key Performance Indicators)?

Your one stop shop for tips on routing node profitability: Running A Profitable Routing Node

Shortcut to auto-fee and auto-KPI instructions


Playground / Sandbox

Click the image below to get information on PLEBNET Playground, a place where you can learn and use the lightning network without risking any real money (signet).

Plebnet Playground Logo


FAQ

A selection of questions frequently asked in PLEBNET groups. FAQ


Resources

Resources

All Pages