Skip to content

docs: Fixing Ubuntu installation guide#9188

Open
ScuttoZ wants to merge 6 commits into
ElementsProject:masterfrom
ScuttoZ:fix-docs
Open

docs: Fixing Ubuntu installation guide#9188
ScuttoZ wants to merge 6 commits into
ElementsProject:masterfrom
ScuttoZ:fix-docs

Conversation

@ScuttoZ

@ScuttoZ ScuttoZ commented Jun 3, 2026

Copy link
Copy Markdown
Collaborator

Important

26.06 FREEZE April 30th: Non-bugfix PRs not ready by this date will wait for 26.09.

RC1 is scheduled on May 14th

The final release is scheduled for June 1st.

Checklist

Before submitting the PR, ensure the following tasks are completed. If an item is not applicable to your PR, please mark it as checked:

  • The changelog has been updated in the relevant commit(s) according to the guidelines.
  • Tests have been added or modified to reflect the changes.
  • Documentation has been reviewed and updated as needed.
  • Related issues have been listed and linked, including any that this PR closes.
  • Important All PRs must consider how to reverse any persistent changes for tools/lightning-downgrade

Changelog-None

Description

Updating installation guide for Ubuntu. Main highlight: dropped support for versions <22.04.
Tested on docker images.

@madelinevibes madelinevibes added this to the v26.09 milestone Jun 4, 2026
@enaples enaples added the QA Blockstream QA team have reproduced, or a test has been created! Look for the linked PR/Issue label Jun 8, 2026
Comment thread doc/getting-started/getting-started/installation.md Outdated
Comment thread doc/getting-started/getting-started/installation.md Outdated
ScuttoZ added 2 commits June 23, 2026 11:50
…r to perform the setup of the timezone before getting dependencies
```shell
sudo apt-get install -y cargo rustfmt protobuf-compiler
sudo apt install -y cargo rustfmt protobuf-compiler
source ~/.cargo/env

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.

This should not be necessary when installing programs from apt since they are installed to paths already in PATH, right?

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

yeah you're right, that slipped

```

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):

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 would still like a link to https://rustup.rs/ so users on ubuntu <25.10 know how to get it.

@daywalker90

Copy link
Copy Markdown
Collaborator

Sorry a few more things:
i verified the steps on ubuntu 22 and 26 and on 22 i stumbled over the issue that i did not install protobuf-compiler because it is on the same line as the rust install which you dont do on 22 because you use rustup. So maybe separate protobuf-compiler to it's own line? Not everyone knows that cargo+rust are both for compiling rust programs and protobuf-compiler is something different.

Also the note for rustup is now duplicate but i like your's more.

After all that please squash this into one commit.

@ScuttoZ

ScuttoZ commented Jun 23, 2026

Copy link
Copy Markdown
Collaborator Author

Sorry a few more things: i verified the steps on ubuntu 22 and 26 and on 22 i stumbled over the issue that i did not install protobuf-compiler because it is on the same line as the rust install which you dont do on 22 because you use rustup. So maybe separate protobuf-compiler to it's own line? Not everyone knows that cargo+rust are both for compiling rust programs and protobuf-compiler is something different.

Does it make sense to place it in the previous block "For development or running tests"?

@daywalker90

Copy link
Copy Markdown
Collaborator

No, because you need it build the rust plugin cln-grpc.

@ScuttoZ

ScuttoZ commented Jun 23, 2026

Copy link
Copy Markdown
Collaborator Author

then I'd add another line after "For ubuntu <25.10 [...]" saying to install protobuf-compiler since it's needed in any case

…eparate command to make sure that the user installs it
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

QA Blockstream QA team have reproduced, or a test has been created! Look for the linked PR/Issue

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants