Skip to content
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.

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

Installation documentation update to work on both Debian and Ubuntu #958

Merged
merged 2 commits into from
Jun 27, 2024

Conversation

AJRepo
Copy link
Contributor

@AJRepo AJRepo commented Jun 26, 2024

Was following the instructions on Debian 12 (bookworm) and had an issue with the command that had

sudo apt install .... liblxc-dev ...

because on Debian liblxc-dev could not be found.

I switched to an Ubuntu 24.04 and found that liblxc-dev is a transitional package for lxc-dev. I.e.

$ apt-cache search liblxc-dev
liblxc-dev - Transitional package - liblxc-dev -> lxc-dev

Thus changing liblxc-dev to lxc-dev documents a process that works on both Debian 12 and Ubuntu 24.

Also ran into an issue compiling as Debian 12 installs golang-go version 1.19 which is too old to compile successfully. Added a note for those running Debian stable.

This PR updates the docs for the above reasons.

@AJRepo AJRepo requested a review from stgraber as a code owner June 26, 2024 01:07
@github-actions github-actions bot added the Documentation Documentation needs updating label Jun 26, 2024
@AJRepo
Copy link
Contributor Author

AJRepo commented Jun 26, 2024

I see the markdownlinter test failed on a few items.

https://github.com/lxc/incus/actions/runs/9671869879/job/26689495231

Have fixed and pushed

@stgraber
Copy link
Member

Looking into this one now

AJRepo and others added 2 commits June 26, 2024 23:07
Signed-off-by: AJRepo <AJRepo@users.noreply.github.com>
Signed-off-by: Stéphane Graber <stgraber@stgraber.org>
Suggested-by: AJRepo <AJRepo@users.noreply.github.com>
@stgraber
Copy link
Member

I did a quick rebase of the changes together but then decided that rather than adding a big chunk of text about using Debian's backports repository, we should just point to our Go requirements and mention getting a supported version from upstream.

That's because we only ever support the last two Go versions, which currently means 1.22 and 1.21 but will soon be 1.23 and 1.22 at which point Debian providing Go 1.21 through backports won't be good enough anymore.

@stgraber stgraber merged commit 37c70e3 into lxc:main Jun 27, 2024
30 checks passed
@AJRepo AJRepo deleted the install_doc_updates branch June 27, 2024 03:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Documentation Documentation needs updating
Development

Successfully merging this pull request may close these issues.

2 participants