From 7fc4fd04eddbd581427d9c211de419f15d547a3b Mon Sep 17 00:00:00 2001 From: enaples Date: Tue, 9 Jun 2026 14:40:35 +0200 Subject: [PATCH 1/2] doc: modernize Alpine build instructions The Alpine compile guide still used the old `./configure && make` flow without Rust or uv. Update it to match the current build: install rustup (packaged rust/cargo can be older than the 1.85.0 MSRV), install uv for Python deps, and build with `RUST_PROFILE=release uv run make`. Changelog-None --- .../getting-started/installation.md | 44 +++++++++++++------ 1 file changed, 31 insertions(+), 13 deletions(-) diff --git a/doc/getting-started/getting-started/installation.md b/doc/getting-started/getting-started/installation.md index 8236c0d147bf..a52fb62e459f 100644 --- a/doc/getting-started/getting-started/installation.md +++ b/doc/getting-started/getting-started/installation.md @@ -619,8 +619,27 @@ A working example that compiles both bitcoind and Core Lightning for Armbian can Get dependencies: ```shell apk update -apk add --virtual .build-deps ca-certificates alpine-sdk autoconf automake git libtool \ -sqlite-dev python3 py3-mako net-tools zlib-dev libsodium gettext +apk add --no-cache \ + alpine-sdk autoconf automake libtool gmp-dev sqlite-dev python3 python3-dev \ + py3-pip py3-mako net-tools zlib-dev libsodium libsodium-dev gettext gettext-dev \ + musl-dev gcc git jq curl wget bash ca-certificates protobuf protobuf-dev \ + postgresql-dev lowdown +``` + +Install Rust via rustup (required for Cargo: +```shell +curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh +. $HOME/.cargo/env +``` + +> 📘 +> +> The `rust`/`cargo` packages shipped by some Alpine releases can be older than Core Lightning's minimum supported Rust version (1.85.0), so installing the toolchain via rustup is recommended. + +Install uv for Python dependency management: +```shell +curl -LsSf https://astral.sh/uv/install.sh | sh +export PATH="$HOME/.local/bin:$PATH" ``` Clone lightning: @@ -630,23 +649,22 @@ cd lightning git submodule update --init --recursive ``` -Build and install: +Checkout a release tag: ```shell -./configure -make -make install +git checkout v26.06.1 ``` -Clean up: +Build and install: ```shell -cd .. && rm -rf lightning -apk del .build-deps +uv sync --all-extras --all-groups --frozen +./configure +RUST_PROFILE=release uv run make -j$(nproc) +RUST_PROFILE=release make install ``` -Install runtime dependencies: -```shell -apk add libgcc libsodium sqlite-libs zlib -``` +> 📘 +> +> If you want to disable Rust because you don't need it or its plugins (cln-grpc, clnrest, cln-bip353 or wss-proxy), you can use `./configure --disable-rust` and skip the rustup step above. ## Python plugins From 672215e3a05e02375a0ccef23275e3e2c0609256 Mon Sep 17 00:00:00 2001 From: enaples Date: Tue, 23 Jun 2026 12:16:16 +0200 Subject: [PATCH 2/2] docs: bump cln version to v26.09 + restore clanup section Changelog-None --- .../getting-started/installation.md | 32 ++++++++++++++----- 1 file changed, 24 insertions(+), 8 deletions(-) diff --git a/doc/getting-started/getting-started/installation.md b/doc/getting-started/getting-started/installation.md index a52fb62e459f..4f735cabb22a 100644 --- a/doc/getting-started/getting-started/installation.md +++ b/doc/getting-started/getting-started/installation.md @@ -101,7 +101,7 @@ cd lightning Checkout a release tag: ```shell -git checkout v25.02 +git checkout v26.09 ``` For development or running tests, get additional dependencies: @@ -214,7 +214,7 @@ cd lightning Checkout a release tag: ```shell -git checkout v24.05 +git checkout v26.09 ``` Build and install lightning: @@ -388,7 +388,7 @@ cd lightning Checkout a release tag: ```shell -git checkout v24.05 +git checkout v26.09 ``` Build lightning: @@ -465,7 +465,7 @@ cd lightning Checkout a release tag: ```shell -git checkout v24.05 +git checkout v26.09 ``` Build lightning: @@ -619,14 +619,23 @@ A working example that compiles both bitcoind and Core Lightning for Armbian can Get dependencies: ```shell apk update -apk add --no-cache \ +``` + +Install the runtime dependencies (these must stay installed to run `lightningd`): +```shell +apk add --no-cache libgcc libsodium sqlite-libs zlib libpq +``` + +Install the build dependencies as a virtual package so they can be removed later: +```shell +apk add --no-cache --virtual .build-deps \ alpine-sdk autoconf automake libtool gmp-dev sqlite-dev python3 python3-dev \ - py3-pip py3-mako net-tools zlib-dev libsodium libsodium-dev gettext gettext-dev \ + py3-pip py3-mako net-tools zlib-dev libsodium-dev gettext gettext-dev \ musl-dev gcc git jq curl wget bash ca-certificates protobuf protobuf-dev \ postgresql-dev lowdown ``` -Install Rust via rustup (required for Cargo: +Install Rust via rustup (required for Cargo): ```shell curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh . $HOME/.cargo/env @@ -651,7 +660,7 @@ git submodule update --init --recursive Checkout a release tag: ```shell -git checkout v26.06.1 +git checkout v26.09 ``` Build and install: @@ -666,6 +675,13 @@ RUST_PROFILE=release make install > > If you want to disable Rust because you don't need it or its plugins (cln-grpc, clnrest, cln-bip353 or wss-proxy), you can use `./configure --disable-rust` and skip the rustup step above. +Clean up (recommended to keep a minimal Alpine image): +```shell +cd .. && rm -rf lightning +apk del .build-deps +rm -rf "$HOME/.rustup" "$HOME/.cargo" "$HOME/.local/share/uv" "$HOME/.cache/uv" +``` + ## Python plugins Python plugins will be installed with the `poetry install` step mentioned above from development setup.