Skip to content

doc: modernize Alpine build instructions #9204

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
enaples wants to merge 1 commit into
base: master
Choose a base branch
from
+31 −13
Open

doc: modernize Alpine build instructions #9204

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
44 changes: 31 additions & 13 deletions doc/getting-started/getting-started/installation.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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:

@nGoline nGoline Jun 11, 2026

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
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
```

> 📘
>
> 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:
Expand All @@ -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:

@nGoline nGoline Jun 11, 2026

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've noticed you removed the clean-up steps. Isn't it desired for a minimal build like Alpine?

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

Expand Down
Loading