Storm Dragon
49 lines
1.3 KiB
Markdown
49 lines
1.3 KiB
Markdown
# System Updates
|
|
|
|
## Overview
|
|
|
|
The Stormux Gaming Image uses a read-only root filesystem on x86_64 images, so the System Update option updates managed Stormux files in your home directory. It refreshes the game menu, launcher scripts, installer recipes, documentation, and other files shipped under `/home/stormux`.
|
|
|
|
System package updates and root filesystem changes are delivered in new image builds.
|
|
|
|
## How to Update
|
|
|
|
1. Open the Game Launcher.
|
|
2. Navigate to System, then Power.
|
|
3. Select System Update.
|
|
4. Wait for the spoken update messages to finish.
|
|
|
|
The menu restarts automatically after the update so any menu changes are loaded immediately.
|
|
|
|
## What Gets Updated
|
|
|
|
System Update downloads the latest `home/` tree from the Stormux gaming image files repository and applies it to `/home/stormux`.
|
|
|
|
The update preserves file permissions, executable bits, and symbolic links from the repository.
|
|
|
|
## Preserved Local Data
|
|
|
|
The update skips local state and user data, including:
|
|
|
|
- `.baremetal`
|
|
- `.cache/`
|
|
- `.config/stormux/game_launcher.conf`
|
|
- `.irssi/`
|
|
- `.local/.services/`
|
|
- `.local/etc/NetworkManager/`
|
|
- `.local/games/`
|
|
- `.local/var/`
|
|
- `.w3m/`
|
|
- `Downloads/`
|
|
- `Logs/`
|
|
|
|
## Update Logs
|
|
|
|
Update output is written to:
|
|
|
|
```text
|
|
~/Logs/system-updates.log
|
|
```
|
|
|
|
If the update fails, review that file and contact Stormux with the log if you need help.
|