Clarify which snap channel we recommend (#14558)

canonical · Dec 2, 2024 · 7ca74e1 · 7ca74e1
2 parents fbd4a6c + eca2ceb
commit 7ca74e1
Show file tree

Hide file tree

Showing 3 changed files with 8 additions and 9 deletions.
diff --git a/doc/howto/migrate_from_lxc.md b/doc/howto/migrate_from_lxc.md
@@ -25,9 +25,9 @@ The `lxd.lxc-to-lxd` command was last included in the 5.0 snap which should be i
         sudo install lxd --channel=5.0/stable
         sudo lxd.lxc-to-lxd --all
 
-After successfully running the `lxd.lxc-to-lxd` command, you can then switch to a newer snap channel if desired, like the latest one:
+After successfully running the `lxd.lxc-to-lxd` command, you can then switch to a newer snap channel if desired, like the 5.21 one:
 
-        sudo refresh lxd --channel=latest/stable
+        sudo refresh lxd --channel=5.21/stable
 ```
 
 Otherwise, make sure that you have `go` ({ref}`requirements-go`) installed and get the tool with the following command:

diff --git a/doc/howto/snap.md b/doc/howto/snap.md
@@ -18,8 +18,6 @@ When running LXD in a production environment, you must make sure to have a suita
 Snaps come with different channels that define which release of a snap is installed and tracked for updates.
 See [Channels and tracks](https://snapcraft.io/docs/channels) in the snap documentation for detailed information.
 
-Feature releases of LXD are available on the `latest` track.
-In addition, LXD provides tracks for the supported feature releases.
 See {ref}`installing-release` for more information.
 
 On all tracks, the `stable` risk level contains all fixes and features for the respective track, but it is only updated when the LXD team decides that a feature is ready and no issues have been revealed by users running the same revision on higher risk levels (`edge` and `candidate`).
@@ -30,7 +28,7 @@ When installing a snap, specify the channel as follows:
 
 For example:
 
-    sudo snap install lxd --channel=latest/stable
+    sudo snap install lxd --channel=5.21/stable
 
 If you do not specify a channel, snap will choose the default channel (the latest LTS release).
 

diff --git a/doc/installing.md b/doc/installing.md
@@ -51,9 +51,10 @@ Complete the following steps to install the snap:
    See the [installation instructions](https://snapcraft.io/docs/installing-snapd) in the Snapcraft documentation.
 
 1. Install the snap package.
-   For the latest feature release, use:
 
-        sudo snap install lxd --channel=latest/stable
+   For the current LTS release (**recommended** option), use:
+
+        sudo snap install lxd
 
    For the LXD 5.21 LTS release, use:
 
@@ -71,9 +72,9 @@ On Ubuntu 18.04 LTS, if you previously had the LXD deb package installed, you ca
         sudo install lxd --channel=5.0/stable
         sudo lxd.migrate
 
-After successfully running the `lxd.migrate` command, you can then switch to a newer snap channel if desired, like the latest one:
+After successfully running the `lxd.migrate` command, you can then switch to a newer snap channel if desired, like the 5.21 one:
 
-        sudo refresh lxd --channel=latest/stable
+        sudo refresh lxd --channel=5.21/stable
 ```
 
 If you want the current user to be able to interact with the LXD daemon, add it to the `lxd` group as the installation process does not add it for you: