I have gotten inspired from trying to participate in NotATether's Lightning challenge, and decided to undertake on a massivebig project here. I am well aware that there are various guides online, documentation and everything but as my experience trying to set up lightning shows, they have issues. Sometimes information is lacking, sometimes they have errors or outdated instructions, and other times they come with different assumptions of user knowledge which are implicit and not warranted or helpful.

My focus will be on desktop wallets, as mobile wallets usually do not require guides or require minimum setup. If you have issues with a mobile application, contact the developers of it. It is likely related to your specific device and OS version configuration.

This is an experimental break-down of every wallet that I have attempted to install. The introduction is written ahead of time, and at the time of writing I do not know how many wallets I will attempt or how many days it will take me to publish a partial version of this thread. The guide will also focus on providing information for a single operating system using up to date information. If someone else wants to repeat this process for your own OS, you are very welcome to contribute with that information. If you have suggestions or feedback, feel free to post them here or DM me directly.  

Important Reminders

• This is an installation guide, using the software to open channels and make transactions is not part of this. I may add this information later.
• Some attempts might not work out, as was the case with my first try using Eclair. But that doesn’t make the guide less valuable, failure is an integral part of this journey. As we figure things out, I’ll update the guide accordingly. There will also be a FAQ section which is very much needed. My personal experience is that sometimes looking up information regarding errors results with no useful information.
• At times basic Linux knowledge is required and expected. If you're new to Linux, make sure you're comfortable with tasks like navigating directories, using the terminal, and more. If you're not sure, check out a guide such as this one: https://www.geeksforgeeks.org/30-days-of-linux/. For those that have a GUI, you will have an easier time just using it for basic operations instead of the commands but you are welcome to try and learn.

---

Part 1: Overview and shared Prerequisites and Installation

The list of LN wallets that are part of this guide:

• eclair: https://github.com/ACINQ/eclair.
• LND: https://github.com/lightningnetwork/lnd
• c-lightningCore Lightning: avantgardenelementsproject/c-lightning" class="ul" rel="ugc">https://github.com/avantgardenelementsproject/c-lightning
• to be determined

Operating System: Ubuntu 24.04 LTS, desktop or server.
To limit duplication of information, a short-guide for Bitcoin Core will be provided in this section. For each wallet it will be mentioned individually if this is a prerequisite.

Bitcoin Core Setup:
1. Download the latest release from here: https://bitcoincore.org/en/download/. At the time of writing this was v29.0. In most situations where Ubuntu is usually used, you will require the file that is linked as Linux (tgz). Note: If you want to do additional verification on the download, the instructions for several operating systems are found on the same link. I will not reproduce them here. I will work in the /home/ folder but you can work in any location of your preference. Open a terminal and run the following commands, which are always shown in code blocks:
2. Extract the contents of the file to a location of your choosing. It can be on the desktop but anywhere else that you are comfortable with. Actually, you can just copy theWe will extract bitcoind and bitcoin-cli to your target location and ignore the remainign files. /usr/local/bin so that they can be called from anywhere using terminal
3. The default data directory is /root/.bitcoin, and to keep things simple we will also use this location. You can change this by specifying --datadir if you want. In this step, we create the directory, the bitcoin.conf files and specify the needed configurations. I will use nano as the text editor as it is more user friendly.  
Use the following configuration options and make sure to specify your own RPC username and password.
Information about each option used here is provided in the FAQ. Please read the 3rd post of this thread. Note: You will need 750 GB or more disk space to run a full node.

4. If you have done everything correctly the following things will be done: First start bitcoind, and give it a few seconds of time to run properly. Then use bitcoin-cli to create a new wallet called wallet.
To confirm you have done this successfully, you will receive a response like this:
Next, a shutdown of the software is done using the -cli and it is started again using the bitcoind. Note: as some system configurations can be slow, always give bitcoind a few seconds of time before running the next command in any code block. If you run commands too fast after startup you will receive a error.
While this step was not entirely necessary as Bitcoin Core will automatically load the created wallet in the current instance, it is provided so that the configuration file can be tested. You want to make sure that your wallet will load when you restart the software as well. To check the currently loaded wallets after doing a restart, use the following command:
Again, if you get this response that means you have completed the steps correctly.
5. The final step is to fully synchronize the blockchain. You can check the status of your node with the following command:
You will receive a response like this:
If you see something like this, that means you have successfully completed all steps so far. Congratulations!   The blocks line tells you how many blocks you have synchronized, and the headers tells you the current block number of the Bitcoin blockchain. Alternatively, you can also follow the progress with verificationprogress which needs to reach 0.99 or wait until initialblockdownload is set to false. It is important to remember that synchronization time is not proportional, so if it took you 4 hours to reach 25% of the blocks that does not mean that it will take you just 12 more hours to reach full synchronization.

At this point, I strongly suggest that you take a break and let it synchronize. You have deserved it.

---

Part 2: Eclair
Prerequisites: Bitcoin Core and Adoptium OpenJDK.

Adoptium OpenJDK Setup:
1. In the first step, download the Adoptium JDK from Github: https://github.com/adoptium/temurin21-binaries/releases. Then extract it and move it to /root/opt. The version at the time of writing this guide is 21.0.7+6, so you may need to adjust the wget command if there is a newer version of it is explicitly required by Eclair. This information was sourced from this guide, which I followed to successfully install Adoptium on my own systems. You can consult it if more steps are needed by your configuration.
2. Export the environment variables by editing .bashrc. You need to add the following two quoted lines at the end of the .bashrc file using nano.

3. Next, force an update on .bashrc with the source command and verify the installation:
You should get a response like this:
4. Set the default JAVA version:
If you have multiple versions of java, select this one as the default by entering the right number. In this case select 0. With this, the prerequisites are complete and you can start the Eclair installation process.


Eclair Setup:
1. Download the latest version of eclair-node and extract the files to a separate folder. At the time of writing this is Eclair v0.12.0 and we will again use a folder located in /home. Only the eclair-cli will be moved to a location so that we can access it globally.
2. Next, create .eclair in the root directory similar to what was required for Bitcoin Core and create a configuration file named eclair.conf. The options in bold are those which you need to edit. Make sure that your API password is strong, and that the RPC configuration data matches that which you have set up in bitcoin.conf.

This is a minimum working configuration. Many more configurations and examples can be found here: https://github.com/ACINQ/eclair/blob/master/docs/Configure.md.

3. Next, test that the node can be started. You will see no output, which is good. The test is to just make sure if no errors are thrown. You can exit by pressing CTRL + C.

4. To enable the node to run in the background, a system service needs to be created. To do this, a systemd file must be created using the following nano command:
Copy the following block inside eclair.service:
Afterwards, run the following commands to reload the daemon, enable the service and start it.

5. If you've done everything correctly so far, the eclair node should be runnign by now. To confirm this, run the following command:
You will need to enter your Eclair API password, the one you set up in the file eclair.conf. You will get an output similar to this one, which confirms that your node is successfully running.

Congratulations! You are now ready to use Eclair. For more information, visit the official Eclair documentation: https://github.com/ACINQ/eclair/tree/master/docs, https://github.com/ACINQ/eclair/blob/master/docs/Guides.md, https://github.com/ACINQ/eclair/blob/master/docs/FAQ.md.

---

Part 3: LND
Prerequisites: Bitcoin Core.

1. Download the latest version of LND and extract the files to a separate folder. At the time of writing this is lnd v0.18.5-beta and we will again use a folder located in /home. If you want to do additional verification on binaries, information is provided directly in the release. As you have already learned how to extract files in previous parts of this guide, multiple operations will be done in this step. Following the information from the documentation, we will move the binaries to a location where the system can find it.

2. Before starting LND, a configuration file must be provided. To do this, the .lnd folder must be created in /root/ and a basic configuration must be set in the file lnd.conf. Make sure that your RPC username and password match the ones that you have set up for Bitcoin Core. The configuration only includes the basic necessary configurations and a few recommended lines from the documentation. Please read up on them if you are interested in what they do.

3. If you have done everything correctly, LND can be started simply by writing lnd in the console. However, first we will create a systemctl service using the provided sample file.
Copy the following block inside lnd.service:
Afterwards, run the following commands to reload the daemon, enable the service and start it.

4. The final step involves creating a wallet, after which you will be able to use lncli. Set a strong password of your choosing, a passphrase is optional, and make sure to back up the 24 words.

5. Verify that LND is running correctly using the getinfo command. Keep in mind that you may need to unlock your wallet first with lncli unlock.
You will get a response like this, I have removed some lines from it to keep it shorter:
Congratulations! You are now ready to use LND. Please refer to this guide for more information: https://docs.lightning.engineering/lightning-network-tools/lnd/first-steps-with-lnd.

---

Part 4: avantgardenelementsproject/c-lightning" class="ul" rel="ugc">c-lightningCore Lightning
Prerequisites: Bitcoin Core.
Coming soon1. Download the latest version of lightning and extract the files to a separate folder. At the time of writing this is v25.02.2 and we will use a folder located in /home. As you have already learned how to extract files in previous parts of this guide, multiple operations will be done in this step. Additionally, libpq-dev must be installed to be able to run this implementation.

Code:

cd /home/
wget https://github.com/ElementsProject/lightning/releases/download/v25.02.2/clightning-v25.02.2-Ubuntu-24.04-amd64.tar.xz
tar -xvf clightning-v25.02.2-Ubuntu-24.04-amd64.tar.xz<hrbr>Final Note: There are of course improvements that cansudo apt-get install libpq-dev

2. To be madeable to call the guide. I will do thislightningd and lightning-cli from anywhere, but only after I have testedfor this implementation we will create a symlink as it requires many libraries that come extracted with it works and if I think it is beginner friendly. It is very difficult to write such

Code:

sudo ln -s /home/usr/bin/lightningd /usr/local/bin/
sudo ln -s /home/usr/bin/lightning-cli /usr/local/bin/

3. You can now conduct a big thread from scratch, so I'd rather make many revisions and improvements afterwards to minimize errorstest-run by invoking the command that follows. For exampleFreely exit with CTRL + C when you are ready.

Quote

lightningd --network=bitcoin --log-level=debug

4. Lastly, Iwe will look at moving the bitcoin binariesadd a configuration file so that theylightningd can be globally accessed similar as was done with LNDrun in the background.

Code:

touch /root/.lightning/debug.log
nano /root/.lightning/config

Quote

daemon
log-file=/root/.lightning/debug.log
alias=HelloCoreLightning

I have used again a minimal working configuration, many more options are available here: docs.corelightning.org/docs/configuration.

I have gotten inspired from trying to participate in NotATether's Lightning challenge, and decided to undertake on a massive project here. I am well aware that there are various guides online, documentation and everything but as my experience trying to set up lightning shows, they have issues. Sometimes information is lacking, sometimes they have errors or outdated instructions, and other times they come with different assumptions of user knowledge which are implicit and not warranted or helpful.

My focus will be on desktop wallets, as mobile wallets usually do not require guides or require minimum setup. If you have issues with a mobile application, contact the developers of it. It is likely related to your specific device and OS version configuration.

This is an experimental break-down of every wallet that I have attempted to install. The introduction is written ahead of time, and at the time of writing I do not know how many wallets I will attempt or how many days it will take me to publish a partial version of this thread. The guide will also focus on providing information for a single operating system using up to date information. If someone else wants to repeat this process for your own OS, you are very welcome to contribute with that information. If you have suggestions or feedback, feel free to post them here or DM me directly.  

Important Reminders

• This is an installation guide, using the software to open channels and make transactions is not part of this. I may add this information later.
• Some attempts might not work out, as was the case with my first try using Eclair. But that doesn’t make the guide less valuable, failure is an integral part of this journey. As we figure things out, I’ll update the guide accordingly. There will also be a FAQ section which is very much needed. My personal experience is that sometimes looking up information regarding errors results with no useful information.
• At times basic Linux knowledge is required and expected. If you're new to Linux, make sure you're comfortable with tasks like navigating directories, using the terminal, and more. If you're not sure, check out a guide such as this one: https://www.geeksforgeeks.org/30-days-of-linux/. For those that have a GUI, you will have an easier time just using it for basic operations instead of the commands but you are welcome to try and learn.

---

Part 1: Overview and shared Prerequisites

The list of LN wallets that are part of this guide:

• eclair: https://github.com/ACINQ/eclair.
• LND: https://github.com/lightningnetwork/lnd
• c-lightning: https://github.com/avantgarden/c-lightning
• to be determined

Operating System: Ubuntu 24.04 LTS, desktop or server.
To limit duplication of information, a short-guide for Bitcoin Core will be provided in this section. For each wallet it will be mentioned individually if this is a prerequisite.

Bitcoin Core Setup:
1. Download the latest release from here: https://bitcoincore.org/en/download/. At the time of writing this was v29.0. In most situations where Ubuntu is usually used, you will require the file that is linked as Linux (tgz). Note: If you want to do additional verification on the download, the instructions for several operating systems are found on the same link. I will not reproduce them here. I will work in the /home/ folder but you can work in any location of your preference. Open a terminal and run the following commands, which are always shown in code blocks:
2. Extract the contents of the file to a location of your choosing. It can be on the desktop but anywhere else that you are comfortable with. Actually, you can just copy the extract bitcoind and bitcoin-cli to your target location and ignore the remainign files.
3. The default data directory is /root/.bitcoin, and to keep things simple we will also use this location. You can change this by specifying --datadir if you want. In this step, we create the directory, the bitcoin.conf files and specify the needed configurations. I will use nano as the text editor as it is more user friendly.  
Use the following configuration options and make sure to specify your own RPC username and password.
Information about each option used here is provided in the FAQ. Please read the 3rd post of this thread. Note: You will need 750 GB or more disk space to run a full node.

4. If you have done everything correctly the following things will be done: First start bitcoind, and give it a few seconds of time to run properly. Then use bitcoin-cli to create a new wallet called wallet.
To confirm you have done this successfully, you will receive a response like this:
Next, a shutdown of the software is done using the -cli and it is started again using the bitcoind. Note: as some system configurations can be slow, always give bitcoind a few seconds of time before running the next command in any code block. If you run commands too fast after startup you will receive a error.
While this step was not entirely necessary as Bitcoin Core will automatically load the created wallet in the current instance, it is provided so that the configuration file can be tested. You want to make sure that your wallet will load when you restart the software as well. To check the currently loaded wallets after doing a restart, use the following command:
Again, if you get this response that means you have completed the steps correctly.
5. The final step is to fully synchronize the blockchain. You can check the status of your node with the following command:
You will receive a response like this:
If you see something like this, that means you have successfully completed all steps so far. Congratulations!   The blocks line tells you how many blocks you have synchronized, and the headers tells you the current block number of the Bitcoin blockchain. Alternatively, you can also follow the progress with verificationprogress which needs to reach 0.99 or wait until initialblockdownload is set to false. It is important to remember that synchronization time is not proportional, so if it took you 4 hours to reach 25% of the blocks that does not mean that it will take you just 12 more hours to reach full synchronization.

At this point, I strongly suggest that you take a break and let it synchronize. You have deserved it.

---

Part 2: Eclair
Prerequisites: Bitcoin Core and Adoptium OpenJDK.

Adoptium OpenJDK Setup:
1. In the first step, download the Adoptium JDK from Github: https://github.com/adoptium/temurin21-binaries/releases. Then extract it and move it to /root/opt. The version at the time of writing this guide is 21.0.7+6, so you may need to adjust the wget command if there is a newer version of it is explicitly required by Eclair. This information was sourced from this guide, which I followed to successfully install Adoptium on my own systems. You can consult it if more steps are needed by your configuration.
2. Export the environment variables by editing .bashrc. You need to add the following two quoted lines at the end of the .bashrc file using nano.

3. Next, force an update on .bashrc with the source command and verify the installation:
You should get a response like this:
4. Set the default JAVA version:
If you have multiple versions of java, select this one as the default by entering the right number. In this case select 0. With this, the prerequisites are complete and you can start the Eclair installation process.


Eclair Setup:
1. Download the latest version of eclair-node and extract the files to a separate folder. At the time of writing this is Eclair v0.12.0 and we will again use a folder located in /home.
2. Next, create .eclair in the root directory similar to what was required for Bitcoin Core and create a configuration file named eclair.conf. The options in bold are those which you need to edit. Make sure that your API password is strong, and that the RPC configuration data matches that which you have set up in bitcoin.conf.

This is a minimum working configuration. Many more configurations and examples can be found here: https://github.com/ACINQ/eclair/blob/master/docs/Configure.md.

3. Next, test that the node can be started. You will see no output, which is good. The test is to just make sure if no errors are thrown. You can exit by pressing CTRL + C.

4. To enable the node to run in the background, a system service needs to be created. To do this, a systemd file must be created using the following nano command:
Copy the following block inside eclair.service:
Afterwards, run the following commands to reload the daemon, enable the service and start it.

5. If you've done everything correctly so far, the eclair node should be runnign by now. To confirm this, run the following command:
You will need to enter your Eclair API password, the one you set up in the file eclair.conf. You will get an output similar to this one, which confirms that your node is successfully running.

Congratulations! You are now ready to use Eclair. For more information, visit the official Eclair documentation: https://github.com/ACINQ/eclair/tree/master/docs, https://github.com/ACINQ/eclair/blob/master/docs/Guides.md, https://github.com/ACINQ/eclair/blob/master/docs/FAQ.md.

---

Part 3: LND
Prerequisites: Bitcoin Core.

1. Download the latest version of LND and extract the files to a separate folder. At the time of writing this is lnd v0.18.5-beta and we will again use a folder located in /home. If you want to do additional verification on binaries, information is provided directly in the release. As you have already learned how to extract files in previous parts of this guide, multiple operations will be done in this step. Following the information from the documentation, we will move the binaries to a location where the system can find it.

2. Before starting LND, a configuration file must be provided. To do this, the .lnd folder must be created in /root/ and a basic configuration must be set in the file lnd.conf. Make sure that your RPC username and password match the ones that you have set up for Bitcoin Core. The configuration only includes the basic necessary configurations and a few recommended lines from the documentation. Please read up on them if you are interested in what they do.

3. If you have done everything correctly, LND can be started simply by writing lnd in the console. However, first we will create a systemctl service using the provided sample file.
Copy the following block inside lnd.service:
Afterwards, run the following commands to reload the daemon, enable the service and start it.

4. The final step involves creating a wallet, after which you will be able to use lncli. Set a strong password of your choosing, a passphrase is optional, and make sure to back up the 24 words.

5. Verify that LND is running correctly using the getinfo command. Keep in mind that you may need to unlock your wallet first with lncli unlock.
You will get a response like this, I have removed some lines from it to keep it shorter:
Congratulations.! You are now ready to use LND. Please refer to this guide for more information: https://docs.lightning.engineering/lightning-network-tools/lnd/first-steps-with-lnd.

---

Part 4: c-lightning
Prerequisites: Bitcoin Core.
Coming soon.

---

Final Note: There are of course improvements that can be made to the guide. I will do this, but only after I have tested that it works and if I think it is beginner friendly. It is very difficult to write such a big thread from scratch, so I'd rather make many revisions and improvements afterwards to minimize errors. For example, I will look at moving the bitcoin binaries so that they can be globally accessed similar as was done with LND.

I have gotten inspired from trying to participate in NotATether's Lightning challenge, and decided to undertake on a massive project here. I am well aware that there are various guides online, documentation and everything but as my experience trying to set up lightning shows, they have issues. Sometimes information is lacking, sometimes they have errors or outdated instructions, and other times they come with different assumptions of user knowledge which are implicit and not warranted or helpful.

My focus will be on desktop wallets, as mobile wallets usually do not require guides or require minimum setup. If you have issues with a mobile application, contact the developers of it. It is likely related to your specific device and OS version configuration.

This is an experimental break-down of every wallet that I have attempted to install. The introduction is written ahead of time, and at the time of writing I do not know how many wallets I will attempt or how many days it will take me to publish a partial version of this thread. The guide will also focus on providing information for a single operating system using up to date information. If someone else wants to repeat this process for your own OS, you are very welcome to contribute with that information. If you have suggestions or feedback, feel free to post them here or DM me directly.  

Important Reminders

• This is an installation guide, using the software to open channels and make transactions is not part of this.
• Some attempts might not work out, as was the case with my first try using Eclair. But that doesn’t make the guide less valuable, failure is an integral part of this journey. As we figure things out, I’ll update the guide accordingly. There will also be a FAQ section which is very much needed. My personal experience is that sometimes looking up information regarding errors results with no useful information.
• At times basic Linux knowledge is required and expected. If you're new to Linux, make sure you're comfortable with tasks like navigating directories, using the terminal, and more. If you're not sure, check out a guide such as this one: https://www.geeksforgeeks.org/30-days-of-linux/. For those that have a GUI, you will have an easier time just using it for basic operations instead of the commands but you are welcome to try and learn.

---

Part 1: Overview and shared Prerequisites

The list of LN wallets that are part of this guide:

• eclair: https://github.com/ACINQ/eclair.
• LND: https://github.com/lightningnetwork/lnd
• c-lightning: https://github.com/avantgarden/c-lightning
• to be determined

Operating System: Ubuntu 24.04 LTS, desktop or server.

To limit duplication of information, a short-guide for Bitcoin Core will be provided in this section. For each wallet it will be mentioned individually if this is a prerequisite.

Bitcoin Core Setup:
1. Download the latest release from here: https://bitcoincore.org/en/download/. At the time of writing this was v29.0. In most situations where Ubuntu is usually used, you will require the file that is linked as Linux (tgz). Note: If you want to do additional verification on the download, the instructions for several operating systems are found on the same link. I will not reproduce them here. I will work in the /home/ folder but you can work in any location of your preference. Open a terminal and run the following commands, which are always shown in code blocks:
2. Extract the contents of the file to a location of your choosing. It can be on the desktop but anywhere else that you are comfortable with. Actually, you can just copy the extract bitcoind and bitcoin-cli to your target location and ignore the remainign files.
3. The default data directory is /root/.bitcoin, and to keep things simple we will also use this location. You can change this by specifying --datadir if you want. In this step, we create the directory, the bitcoin.conf files and specify the needed configurations. I will use nano as the text editor as it is more user friendly.  
Use the following configuration options and make sure to specify your own RPC username and password.
Information about each option used here is provided in the FAQ. Please read the 3rd post of this thread. Note: You will need 750 GB or more disk space to run a full node.

4. If you have done everything correctly the following things will be done: First start bitcoind, and give it a few seconds of time to run properly. Then use bitcoin-cli to create a new wallet called wallet.
To confirm you have done this successfully, you will receive a response like this:
Next, a shutdown of the software is done using the -cli and it is started again using the bitcoind. Note: as some system configurations can be slow, always give bitcoind a few seconds of time before running the next command in any code block. If you run commands too fast after startup you will receive a error.
While this step was not entirely necessary as Bitcoin Core will automatically load the created wallet in the current instance, it is provided so that the configuration file can be tested. You want to make sure that your wallet will load when you restart the software as well. To check the currently loaded wallets after doing a restart, use the following command:
Again, if you get this response that means you have completed the steps correctly.
5. The final step is to fully synchronize the blockchain. You can check the status of your node with the following command:
You will receive a response like this:
If you see something like this, that means you have successfully completed all steps so far. Congratulations!   The blocks line tells you how many blocks you have synchronized, and the headers tells you the current block number of the Bitcoin blockchain. Alternatively, you can also follow the progress with verificationprogress which needs to reach 0.99 or wait until initialblockdownload is set to false. It is important to remember that synchronization time is not proportional, so if it took you 4 hours to reach 25% of the blocks that does not mean that it will take you just 12 more hours to reach full synchronization.

At this point, I strongly suggest that you take a break and let it synchronize. You have deserved it.

---

Part 2: Eclair
Prerequisites: Bitcoin Core and Adoptium OpenJDK.

Adoptium OpenJDK Setup:
1. In the first step, download the Adoptium JDK from Github: https://github.com/adoptium/temurin21-binaries/releases. Then extract it and move it to /root/opt. The version at the time of writing this guide is 21.0.7+6, so you may need to adjust the wget command if there is a newer version of it is explicitly required by Eclair. This information was sourced from this guide, which I followed to successfully install Adoptium on my own systems. You can consult it if more steps are needed by your configuration.
2. Export the environment variables by editing .bashrc. You need to add the following two quoted lines at the end of the .bashrc file using nano.

3. Next, force an update on .bashrc with the source command and verify the installation:
You should get a response like this:
4. Set the default JAVA version:
If you have multiple versions of java, select this one as the default by entering the right number. In this case select 0. With this, the prerequisites are complete and you can start the Eclair installation process.


Eclair Setup:
1. Download the latest version of eclair-node and extract the files to a separate folder. At the time of writing this is Eclair v0.12.0 and we will again use a folder located in /home.
2. Next, create .eclair in the root directory similar to what was required for Bitcoin Core and create a configuration file named eclair.conf. The options in bold are those which you need to edit. Make sure that your API password is strong, and that the RPC configuration data matches that which you have set up in bitcoin.conf.

This is a minimum working configuration. Many more configurations and examples can be found here: https://github.com/ACINQ/eclair/blob/master/docs/Configure.md.

3. Next, test that the node can be started. You will see no output, which is good. The test is to just make sure if no errors are thrown. You can exit by pressing CTRL + C.

4. To enable the node to run in the background, a system service needs to be created. To do this, a systemd file must be created using the following nano command:
Copy the following block inside eclair.service:
Afterwards, run the following commands to reload the daemon, enable the service and start it.

5. If you've done everything correctly so far, the eclair node should be runnign by now. To confirm this, run the following command:
You will need to enter your Eclair API password, the one you set up in the file eclair.conf. You will get an output similar to this one, which confirms that your node is successfully running.

For more information, visit the official Eclair documentation: https://github.com/ACINQ/eclair/tree/master/docs, https://github.com/ACINQ/eclair/blob/master/docs/Guides.md, https://github.com/ACINQ/eclair/blob/master/docs/FAQ.md.

---

Part 3: LND
Prerequisites: Bitcoin Core.

1. Download the latest version of LND and extract the files to a separate folder. At the time of writing this is lnd v0.18.5-beta and we will again use a folder located in /home. If you want to do additional verification on binaries, information is provided directly in the release. As you have already learned how to extract files in previous parts of this guide, multiple operations will be done in this step. Following the information from the documentation, we will move the binaries to a location where the system can find it.

2. Before starting LND, a configuration file must be provided. To do this, the .lnd folder must be created in /root/ and a basic configuration must be set in the file lnd.conf. Make sure that your RPC username and password match the ones that you have set up for Bitcoin Core. The configuration only includes the basic necessary configurations and a few recommended lines from the documentation. Please read up on them if you are interested in what they do.

3. If you have done everything correctly, LND can be started simply by writing lnd in the console. However, first we will create a systemctl service using the provided sample file.
Copy the following block inside lnd.service:
Afterwards, run the following commands to reload the daemon, enable the service and start it.

4. The final step involves creating a wallet, after which you will be able to use lncli. Set a strong password of your choosing, a passphrase is optional, and make sure to back up the 24 words.

5. Verify that LND is running correctly using the getinfo command. Keep in mind that you may need to unlock your wallet first with lncli unlock.
You will get a response like this, I have removed some lines from it to keep it shorter:
Congratulations. You are now ready to use LND. Please refer to this guide for more information: https://docs.lightning.engineering/lightning-network-tools/lnd/first-steps-with-lnd.

---

Part 4: c-lightning
Prerequisites: Bitcoin Core.
Coming soon.

---

Final Note: There are of course improvements that can be made to the guide. I will do this, but only after I have tested that it works and if I think it is beginner friendly. It is very difficult to write such a big thread from scratch, so I'd rather make many revisions and improvements afterwards to minimize errors. For example, I will look at moving the bitcoin binaries so that they can be globally accessed similar as was done with LND.

I have gotten inspired from trying to participate in NotATether's Lightning challenge, and decided to undertake on a massive project here. I am well aware that there are various guides online, documentation and everything but as my experience trying to set up lightning shows, they have issues. Sometimes information is lacking, sometimes they have errors or outdated instructions, and other times they come with different assumptions of user knowledge which are implicit and not warranted or helpful.

My focus will be on desktop wallets, as mobile wallets usually do not require guides or require minimum setup. If you have issues with a mobile application, contact the developers of it. It is likely related to your specific device and OS version configuration.

This is an experimental break-down of every wallet that I have attempted to install. The introduction is written ahead of time, and at the time of writing I do not know how many wallets I will attempt or how many days it will take me to publish a partial version of this thread. The guide will also focus on providing information for a single operating system using up to date information. If someone else wants to repeat this process for your own OS, you are very welcome to contribute with that information. If you have suggestions or feedback, feel free to post them here or DM me directly.  

Important Reminders

• This is an installation guide, using the software to open channels and make transactions is not part of this.
• Some attempts might not work out, as was the case with my first try using Eclair. But that doesn’t make the guide less valuable, failure is an integral part of this journey. As we figure things out, I’ll update the guide accordingly. There will also be a FAQ section which is very much needed. My personal experience is that sometimes looking up information regarding errors results with no useful information.
• At times basic Linux knowledge is required and expected. If you're new to Linux, make sure you're comfortable with tasks like navigating directories, using the terminal, and more. If you're not sure, check out a guide such as this one: https://www.geeksforgeeks.org/30-days-of-linux/. For those that have a GUI, you will have an easier time just using it for basic operations instead of the commands but you are welcome to try and learn.

---

Part 1: Overview and shared Prerequisites

The list of LN wallets that are part of this guide:

• eclair: https://github.com/ACINQ/eclair.
• LND: https://github.com/lightningnetwork/lnd
• c-lightning: https://github.com/avantgarden/c-lightning
• to be determined

Operating System: Ubuntu 24.04 LTS, desktop or server.

To limit duplication of information, a short-guide for Bitcoin Core will be provided in this section. For each wallet it will be mentioned individually if this is a prerequisite.

Bitcoin Core Setup:
1. Download the latest release from here: https://bitcoincore.org/en/download/. At the time of writing this was v29.0. In most situations where Ubuntu is usually used, you will require the file that is linked as Linux (tgz). Note: If you want to do additional verification on the download, the instructions for several operating systems are found on the same link. I will not reproduce them here. I will work in the /home/ folder but you can work in any location of your preference. Open a terminal and run the following commands, which are always shown in code blocks:
2. Extract the contents of the file to a location of your choosing. It can be on the desktop but anywhere else that you are comfortable with. Actually, you can just copy the extract bitcoind and bitcoin-cli to your target location and ignore the remainign files.
3. The default data directory is /root/.bitcoin, and to keep things simple we will also use this location. You can change this by specifying --datadir if you want. In this step, we create the directory, the bitcoin.conf files and specify the needed configurations. I will use nano as the text editor as it is more user friendly.  
Use the following configuration options and make sure to specify your own RPC username and password.
Information about each option used here is provided in the FAQ. Please read the 3rd post of this thread. Note: You will need 750 GB or more disk space to run a full node.

4. If you have done everything correctly the following things will be done: First start bitcoind, and give it a few seconds of time to run properly. Then use bitcoin-cli to create a new wallet called wallet.
To confirm you have done this successfully, you will receive a response like this:
Next, a shutdown of the software is done using the -cli and it is started again using the bitcoind. Note: as some system configurations can be slow, always give bitcoind a few seconds of time before running the next command in any code block. If you run commands too fast after startup you will receive a error.
While this step was not entirely necessary as Bitcoin Core will automatically load the created wallet in the current instance, it is provided so that the configuration file can be tested. You want to make sure that your wallet will load when you restart the software as well. To check the currently loaded wallets after doing a restart, use the following command:
Again, if you get this response that means you have completed the steps correctly.
5. The final step is to fully synchronize the blockchain. You can check the status of your node with the following command:
You will receive a response like this:
If you see something like this, that means you have successfully completed all steps so far. Congratulations!   The blocks line tells you how many blocks you have synchronized, and the headers tells you the current block number of the Bitcoin blockchain. Alternatively, you can also follow the progress with verificationprogress which needs to reach 0.99 or wait until initialblockdownload is set to false. It is important to remember that synchronization time is not proportional, so if it took you 4 hours to reach 25% of the blocks that does not mean that it will take you just 12 more hours to reach full synchronization.

At this point, I strongly suggest that you take a break and let it synchronize. You have deserved it.

---

Part 2: Eclair
Prerequisites: Bitcoin Core and Adoptium OpenJDK.

Adoptium OpenJDK Setup:
1. In the first step, download the Adoptium JDK from Github: https://github.com/adoptium/temurin21-binaries/releases. Then extract it and move it to /root/opt. The version at the time of writing this guide is 21.0.7+6, so you may need to adjust the wget command if there is a newer version of it is explicitly required by Eclair. This information was sourced from this guide, which I followed to successfully install Adoptium on my own systems. You can consult it if more steps are needed by your configuration.
2. Export the environment variables by editing .bashrc. You need to add the following two quoted lines at the end of the .bashrc file using nano.

3. Next, force an update on .bashrc with the source command and verify the installation:
You should get a response like this:
4. Set the default JAVA version:
If you have multiple versions of java, select this one as the default by entering the right number. In this case select 0. With this, the prerequisites are complete and you can start the Eclair installation process.


Eclair Setup:
1. Download the latest version of eclair-node and extract the files to a separate folder. At the time of writing this is Eclair v0.12.0 and we will again use a folder located in /home.
2. Next, create .eclair in the root directory similar to what was required for Bitcoin Core and create a configuration file named eclair.conf. The options in bold are those which you need to edit. Make sure that your API password is strong, and that the RPC configuration data matches that which you have set up in bitcoin.conf.

This is a minimum working configuration. Many more configurations and examples can be found here: https://github.com/ACINQ/eclair/blob/master/docs/Configure.md.

3. Next, test that the node can be started. You will see no output, which is good. The test is to just make sure if no errors are thrown. You can exit by pressing CTRL + C.

4. To enable the node to run in the background, a system service needs to be created. To do this, a systemd file must be created using the following nano command:
Copy the following block inside eclair.service:
Afterwards, run the following commands to reload the daemon, enable the service and start it.

5. If you've done everything correctly so far, the eclair node should be runnign by now. To confirm this, run the following command:
You will need to enter your Eclair API password, the one you set up in the file eclair.conf. You will get an output similar to this one, which confirms that your node is successfully running.

For more information, visit the official Eclair documentation: https://github.com/ACINQ/eclair/tree/master/docs, https://github.com/ACINQ/eclair/blob/master/docs/Guides.md, https://github.com/ACINQ/eclair/blob/master/docs/FAQ.md.

---

Part 3: LND
Prerequisites: Bitcoin Core.

1. Download the latest version of LND and extract the files to a separate folder. At the time of writing this is lnd v0.18.5-beta and we will again use a folder located in /home. If you want to do additional verification on binaries, information is provided directly in the release. As you have already learned how to extract files in previous parts of this guide, multiple operations will be done in this step. Following the information from the documentation, we will move the binaries to a location where the system can find it.

2. Before starting LND, a configuration file must be provided. To do this, the .lnd folder must be created in /root/ and a basic configuration must be set in the file lnd.conf. Make sure that your RPC username and password match the ones that you have set up for Bitcoin Core. The configuration only includes the basic necessary configurations and a few recommended lines from the documentation. Please read up on them if you are interested in what they do.

3. If you have done everything correctly, LND can be started simply by writing lnd in the console. However, first we will create a systemctl service using the provided sample file.
Copy the following block inside lnd.service:
Afterwards, run the following commands to reload the daemon, enable the service and start it.

4. The final step involves creating a wallet, after which you will be able to use lncli. Set a strong password of your choosing, a passphrase is optional, and make sure to back up the 24 words.

5. Verify that LND is running correctly using the getinfo command. Keep in mind that you may need to unlock your wallet first with lncli unlock.
You will get a response like this, I have removed some lines from it to keep it shorter:
Congratulations. You are now ready to use LND. Please refer to this guide for more information: https://docs.lightning.engineering/lightning-network-tools/lnd/first-steps-with-lnd.

---

Part 4: c-lightning
Prerequisites: Bitcoin Core.
Coming soon.

---

Final Note: There are of course improvements that can be made to the guide. I will do this, but only after I have tested that it works and if I think it is beginner friendly. It is very difficult to write such a big thread from scratch, so I'd rather make many revisions and improvements afterwards to minimize errors.