Skip to content

Commit 5f9a4f5

Browse files
committed
docs: add channel information
1 parent 0132d17 commit 5f9a4f5

1 file changed

Lines changed: 27 additions & 4 deletions

File tree

content/docs/using-apollo/system-administration.md

Lines changed: 27 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,22 +5,45 @@ weight: 2
55

66
# System Administration {anchor=false}
77

8+
## Apollo release channels
9+
10+
> [!INFO]
11+
> The `stable` channel will be changed to a *weekly* cadence at a later date yet to be determined.
12+
13+
Apollo builds images with three different channels. These have different release cadences and target different users.
14+
15+
- **stable**: This channel currently updates *daily* and is the default for Apollo. Recommended for most users.
16+
- **stable-lts**: same as the above, but using the *LTS* version of the kernel. Some users may have a more stable experience with this channel.
17+
- **latest**: This channel updates whenever a change is made to the Apollo git repo, alongside daily builds. Recommended for advanced users and testers **only**.
18+
19+
### Changing release channels:
20+
21+
For users with AMD/Intel graphics:
22+
```bash
23+
sudo bootc switch ghcr.io/apollo-linux/apollo:$channel # replace $channel with the desired channel above
24+
```
25+
26+
For users with Nvidia GTX 16xx/RTX 20xx or newer graphics:
27+
```bash
28+
sudo bootc switch ghcr.io/apollo-linux/apollo-nvidia:$channel # replace $channel with the desired channel above
29+
```
30+
831
## Managing Automatic Updates
932

1033
Automatic updates are the intended way to use Apollo. We use automatic updates by default so users always get the latest bug and security fixes as well as new features.
1134

1235
If you need to pause system updates, e.g., due to a regression, you can also pin your system image to a specific date within the last 90 days like such:
1336

1437
```bash
15-
# replace $image and $tag with your currently booted image and tag (e.g. apollo:latest)
16-
# if you're not sure what image and tag you're running, run sudo bootc status first
38+
# replace $image and $channel with your current image and channel (e.g. apollo:latest)
39+
# if you're not sure what image and channel you're running, run sudo bootc status first
1740
# replace $date with the format YYYYMMDD (e.g. 20260519)
18-
sudo bootc switch ghcr.io/apollo-linux/$image:$tag.$date
41+
sudo bootc switch ghcr.io/apollo-linux/$image:$channel.$date
1942
```
2043

2144
Nontheless, if you still want to disable them you can run the following:
2245
```bash
2346
ajust toggle-automatic-updates
2447
```
2548

26-
When filing bug reports or asking support, please make sure your issue is reproducible on the latest version of Apollo, as the issue may have been fixed in an update.
49+
When filing bug reports or asking for support, please make sure your system is up to date first, as your issue may have been fixed in an update.

0 commit comments

Comments
 (0)