From ddece5c8dbe9c8aa6b75f585abc7435f93e90e11 Mon Sep 17 00:00:00 2001 From: ScuttoZ Date: Wed, 3 Jun 2026 17:38:31 +0200 Subject: [PATCH 1/6] docs: Fixing Ubuntu installation guide --- .../getting-started/installation.md | 24 +++++++++---------- 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/doc/getting-started/getting-started/installation.md b/doc/getting-started/getting-started/installation.md index 8236c0d147bf..dcba5c23a9ae 100644 --- a/doc/getting-started/getting-started/installation.md +++ b/doc/getting-started/getting-started/installation.md @@ -70,23 +70,22 @@ You will also need a version of bitcoind with segregated witness and `estimatesm ## To Build on Ubuntu -OS version: Ubuntu 15.10 or above +OS version: Ubuntu 22.04 or above Get dependencies: ```shell -sudo apt-get update -sudo apt-get install -y \ - jq autoconf automake build-essential git libtool libsqlite3-dev libffi-dev \ - python3 python3-pip net-tools zlib1g-dev libsodium-dev gettext lowdown -pip3 install --upgrade pip +sudo apt update +sudo ln -snf /usr/share/zoneinfo/UTC /etc/localtime && echo UTC > /etc/timezone +sudo apt install -y \ + curl autoconf jq libsecp256k1-dev libsodium-dev automake build-essential git libtool libsqlite3-dev libffi-dev python3 python3-pip net-tools zlib1g-dev gettext pkg-config libssl-dev lowdown python3-mako curl -LsSf https://astral.sh/uv/install.sh | sh ``` -After installing uv, restart your shell or run `source ~/.bashrc` to ensure `uv` is in your PATH. +After installing uv, restart your shell or run `source ~/.local/bin/env` to ensure `uv` is in your PATH. If you don't have Bitcoin installed locally you'll need to install that as well. It's now available via [snapd](https://snapcraft.io/bitcoin-core). ```shell -sudo apt-get install snapd +sudo apt install snapd sudo snap install bitcoin-core # Snap does some weird things with binary names; you'll # want to add a link to them so everything works as expected @@ -101,18 +100,19 @@ cd lightning Checkout a release tag: ```shell -git checkout v25.02 +git checkout v26.06 ``` For development or running tests, get additional dependencies: ```shell -sudo apt-get install -y valgrind libpq-dev shellcheck cppcheck \ - libsecp256k1-dev lowdown +sudo apt install -y valgrind libpq-dev shellcheck cppcheck ``` If you want to build the Rust plugins (cln-grpc, clnrest, cln-bip353 and wss-proxy): ```shell -sudo apt-get install -y cargo rustfmt protobuf-compiler +sudo apt install -y protobuf-compiler +curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y +source ~/.cargo/env ``` > 📘 From 0545037945409810075ef346391d8831b51d145e Mon Sep 17 00:00:00 2001 From: ScuttoZ Date: Tue, 23 Jun 2026 11:50:31 +0200 Subject: [PATCH 2/6] review: removed tzdata config and substituted with comment asking user to perform the setup of the timezone before getting dependencies --- doc/getting-started/getting-started/installation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/getting-started/getting-started/installation.md b/doc/getting-started/getting-started/installation.md index dcba5c23a9ae..dc282c22f1e6 100644 --- a/doc/getting-started/getting-started/installation.md +++ b/doc/getting-started/getting-started/installation.md @@ -75,11 +75,11 @@ OS version: Ubuntu 22.04 or above Get dependencies: ```shell sudo apt update -sudo ln -snf /usr/share/zoneinfo/UTC /etc/localtime && echo UTC > /etc/timezone sudo apt install -y \ curl autoconf jq libsecp256k1-dev libsodium-dev automake build-essential git libtool libsqlite3-dev libffi-dev python3 python3-pip net-tools zlib1g-dev gettext pkg-config libssl-dev lowdown python3-mako curl -LsSf https://astral.sh/uv/install.sh | sh ``` +If installation halts on tzdata configuration, finish the setup of your OS and try again. After installing uv, restart your shell or run `source ~/.local/bin/env` to ensure `uv` is in your PATH. From 8f7ebb739ad1659703343f070d3d30e9504f691c Mon Sep 17 00:00:00 2001 From: ScuttoZ Date: Tue, 23 Jun 2026 11:53:09 +0200 Subject: [PATCH 3/6] review: removed rustup default instal and added comment to have the user make sure they have Rust 1.85+ --- doc/getting-started/getting-started/installation.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/doc/getting-started/getting-started/installation.md b/doc/getting-started/getting-started/installation.md index dc282c22f1e6..64962c72830e 100644 --- a/doc/getting-started/getting-started/installation.md +++ b/doc/getting-started/getting-started/installation.md @@ -108,10 +108,9 @@ For development or running tests, get additional dependencies: sudo apt install -y valgrind libpq-dev shellcheck cppcheck ``` -If you want to build the Rust plugins (cln-grpc, clnrest, cln-bip353 and wss-proxy): +If you want to build the Rust plugins (cln-grpc, clnrest, cln-bip353 and wss-proxy) make sure that you have Rust 1.85+ installed (included on Ubuntu 25.10 or higher): ```shell -sudo apt install -y protobuf-compiler -curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y +sudo apt install -y cargo rustfmt protobuf-compiler source ~/.cargo/env ``` From 24b38f7694d72c4d2fa3ae4b2ea8c0fcf086281f Mon Sep 17 00:00:00 2001 From: ScuttoZ Date: Tue, 23 Jun 2026 12:03:51 +0200 Subject: [PATCH 4/6] review: added rustup reference --- doc/getting-started/getting-started/installation.md | 1 + 1 file changed, 1 insertion(+) diff --git a/doc/getting-started/getting-started/installation.md b/doc/getting-started/getting-started/installation.md index 64962c72830e..3220adb4f0b2 100644 --- a/doc/getting-started/getting-started/installation.md +++ b/doc/getting-started/getting-started/installation.md @@ -113,6 +113,7 @@ If you want to build the Rust plugins (cln-grpc, clnrest, cln-bip353 and wss-pro sudo apt install -y cargo rustfmt protobuf-compiler source ~/.cargo/env ``` +For Ubuntu <25.10, all details about installing Rust can be found at https://rustup.rs/. > 📘 > From d2b1cb88c22d3c9f6e575b6f1101c25054b38cd7 Mon Sep 17 00:00:00 2001 From: ScuttoZ Date: Tue, 23 Jun 2026 12:25:44 +0200 Subject: [PATCH 5/6] typo --- doc/getting-started/getting-started/installation.md | 1 - 1 file changed, 1 deletion(-) diff --git a/doc/getting-started/getting-started/installation.md b/doc/getting-started/getting-started/installation.md index 3220adb4f0b2..83daa1d8f698 100644 --- a/doc/getting-started/getting-started/installation.md +++ b/doc/getting-started/getting-started/installation.md @@ -111,7 +111,6 @@ sudo apt install -y valgrind libpq-dev shellcheck cppcheck If you want to build the Rust plugins (cln-grpc, clnrest, cln-bip353 and wss-proxy) make sure that you have Rust 1.85+ installed (included on Ubuntu 25.10 or higher): ```shell sudo apt install -y cargo rustfmt protobuf-compiler -source ~/.cargo/env ``` For Ubuntu <25.10, all details about installing Rust can be found at https://rustup.rs/. From 84a3b8b40ae4e305930d05d6ab18dfadbd4db960 Mon Sep 17 00:00:00 2001 From: ScuttoZ Date: Tue, 23 Jun 2026 16:50:24 +0200 Subject: [PATCH 6/6] removed duplicate rustup reference and moved protobuf-compiler to a separate command to make sure that the user installs it --- doc/getting-started/getting-started/installation.md | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/doc/getting-started/getting-started/installation.md b/doc/getting-started/getting-started/installation.md index 83daa1d8f698..adc52336cf57 100644 --- a/doc/getting-started/getting-started/installation.md +++ b/doc/getting-started/getting-started/installation.md @@ -110,13 +110,16 @@ sudo apt install -y valgrind libpq-dev shellcheck cppcheck If you want to build the Rust plugins (cln-grpc, clnrest, cln-bip353 and wss-proxy) make sure that you have Rust 1.85+ installed (included on Ubuntu 25.10 or higher): ```shell -sudo apt install -y cargo rustfmt protobuf-compiler +sudo apt install -y cargo rustfmt ``` -For Ubuntu <25.10, all details about installing Rust can be found at https://rustup.rs/. > 📘 > -> If your build fails because of your Rust version, you might want to check out [rustup](https://rustup.rs/) to install a newer version +> For Ubuntu <25.10, all details about installing Rust can be found at https://rustup.rs/. +> In any case, Rust plugins require protocol buffers: +```shell +sudo apt install -y protobuf-compiler +``` There are two ways to build core lightning, and this depends on how you want use it.