Difference between revisions of "Main Page"

From PlebNet Wiki
Jump to navigation Jump to search
 
(119 intermediate revisions by 15 users not shown)
Line 1: Line 1:
= PLEBNET for plebs =
<languages/>
<translate>
<!--T:2-->
'''Welcome to PLEBNET!'''


== Getting Started ==
<!--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]].


You need a [https://en.wikipedia.org/wiki/Lightning_Network Lightning Network] node and [https://telegram.org/ Telegram] in order join [http://plebnet.org PLEBNET]. - Read the [https://bitcoiner.guide/lightning/ bitcoiner.guide/lightning] guide to get an overview of how the lighting network works.


=== Node ===
== To read first == <!--T:3-->


There’s several newbie options for getting a Lightning node set up and running * [https://github.com/rootzoll/raspiblitz RaspbiBlitz] is a great option that runs on Raspberry Pi v4+ * [https://getumbrel.com/ Umbrel] is a newbie-friendly package that runs on Raspberry Pi v4+ * [https://youtu.be/fppmhqjqh2E BTC SESSIONS] has a good video walkthrough for getting started with Raspberry Pi and Umbrel * '''Security note for Umbrel:''' ''Your Umbrel node is only as secure as your network (WiFi/LAN).'' Be sure to read the [https://github.com/getumbrel/umbrel/blob/master/SECURITY.md Security Disclosure] from the Umbrel team. * [https://start9.com/ Start9] is an all-in-one option that includes the necessary hardware * [https://www.mynodebtc.com/ myNode] is another all-in-one with hardware * [https://stadicus.github.io/RaspiBolt/ RaspiBolt] has some good information on how to set up the necessary services manually
<!--T:4-->
[[Special:MyLanguage/Welcome to Plebnet|Welcome to PLEBNET]]  


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


PLEBNET discussion and coordination happens on the Telegram chat platform.
[[Notes on Privacy | Important points to consider on how to protect your privacy]]


Download the [https://telegram.org/ Telegram app] and join the [http://kycjelly.com PLEBNET] group.
== Getting Started == <!--T:6-->


The companion Telegram channel [https://t.me/plebnetlibrary PLEBNET Library] contains high quality materials collected from chat group traffic.
<!--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?


=== CheeseRobot ₿ ===
<!--T:8-->
Please see the [[Special:MyLanguage/Getting started|Getting started]] page.


A Telegram bot that will allow you to join and interact with the PLEBNET.


You’ll want to send a private message to <code>@cheeserobot</code> to claim and add your node. Start with <code>/claim</code> and follow the instructions to get add your node id. Then, in the PLEBNET channel, use <code>/id@cheeserobot</code> to get yourself added to the graph.
== Claim your node [optional]== <!--T:9-->


== Opening Channels ==
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.


=== Add Liquidity ===
<!--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).


Generate a Lightning wallet and add some funds so that you can open channels. Keep in mind that PLEBNET prefers [[#keep-it-girthy|girthy channels]], so fund your node accordingly.
<!--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>.


=== Find Nodes in PLEBNET Telegram Group ===
<!--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]]


If you’re not yet able or willing to offer girthy channels and just want to get started with a smaller amount of sats, [https://amboss.space/node/0381de1709efbda38f9afd2d47399caa19a2630c0c795acd24755efa442685fc7d Turgidson] is for PLEBNET newbies and will accept channels as low as 20k.
== Opening Channels == <!--T:13-->


You may want to check out [https://www.youtube.com/watch?v=qnj-ix45tVw Lightning Routing: The First 30 Days] to get some ideas
<!--T:14-->
The first question which a pleb has after (or even before) the node is synced "'''who should I open channel with'''"


Otherwise, you’ll need to find some other nodes in PLEBNET to open channels 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'''


You can go to http://graph.plebnet.org/ to see the current visual graph of nodes, or type <code>/graph@cheeserobot group</code> in the PLEBNET chat. <code>/groupnodes@cheeserobot</code> will output a list of the 50 most recent members and nodes. You can contact plebs
<!--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.


<!--T:17-->
For information relating to lightning channels, including methods to get inbound liquidity see: [[Special:MyLanguage/Opening channels|Opening channels]]


<strong>MediaWiki has been installed.</strong>
== Rebalance Channels ==


Consult the [https://www.mediawiki.org/wiki/Special:MyLanguage/Help:Contents User's Guide] for information on using the wiki software.
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.


== Getting started ==
== Maintaining Proper Node Hygiene == <!--T:18-->
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Configuration_settings Configuration settings list]
 
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:FAQ MediaWiki FAQ]
<!--T:21-->
* [https://lists.wikimedia.org/mailman/listinfo/mediawiki-announce MediaWiki release mailing list]
[[Special:MyLanguage/Node Hardening|Node Hardening]]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Localisation#Translation_resources Localise MediaWiki for your language]
 
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Combating_spam Learn how to combat spam on your wiki]
<!--T:19-->
[[Special:MyLanguage/Maintaining node hygiene|Maintaining node hygiene]]
 
<!--T:20-->
[[Special:MyLanguage/Node Hardware|Node Hardware]]
 
<!--T:22-->
[[Special:MyLanguage/UPS|UPS]] (Uninterrupted Power Supply)
 
[[Reduce_channel_database_size | Keeping Channel DB in check ]]
 
[[Compacting_Channel_DB | Prune and compact channel DB ]]
 
== 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.
 
<!--T:25-->
[[Special:MyLanguage/Backup/Recovery|Backup/Recovery]]
 
 
== 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.  
 
<!--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-->
 
=== Balance of Satoshis === <!--T:33-->
 
<!--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).
 
<!--T:37-->
For more information, and common BoS commands see: [[Special:MyLanguage/Balance of Satoshis|Balance of Satoshis]].
 
<!--T:52-->
[https://github.com/niteshbalusu11/BOS-Commands-Document See this excellent documentation for bos commands]
 
<!--T:34-->
Installation: process for [[Special:MyLanguage/Umbrel - Installing BoS|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.
 
It can be installed [https://github.com/ibz/lightning-shell manually] or via the Umbrel/Citadel app stores
 
Lightning shell includes many useful tools and saves you a lot of time installing them:
 
[[Special:MyLanguage/Umbrel - Installing BoS|Balance of Satoshis]]
 
[https://github.com/edouardparis/lntop lntop]
 
lncli
 
[[Special:MyLanguage/Suez| Suez]]
 
 
== LND Configuration Settings Overview == <!--T:35-->
 
<!--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.
 
<!--T:37-->
[[Special:MyLanguage/LND Configuration Settings|LND Configuration Settings]]
 
 
== Running A Profitable Routing Node == <!--T:38-->
 
<!--T:39-->
Not seeing routing through your node, or your sats are only moving in one direction?
 
<!--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)?
 
<!--T:41-->
'''Your one stop shop for tips on routing node profitability:''' [[Special:MyLanguage/Running A Profitable Routing Node|Running A Profitable Routing Node]]
 
<!--T:42-->
[[Special:MyLanguage/Fees And Profitability|Shortcut to auto-fee and auto-KPI instructions]]
 
 
== Playground / Sandbox == <!--T:43-->
 
<!--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]]
 
 
== 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-->
 
<!--T:49-->
[[Special:MyLanguage/Resources|Resources]]
 
= All Pages = <!--T:50-->
 
 
 
 
</translate>
{{: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