Public commit record
65/100 · Adequate
What the developer wrote
Authored by Tads
Docs: fix new version for krux-installer (#796)
✓ Descriptive subject✓ Names a concrete action or component✓ Uses a recognizable type or scope✓ Links an issue, advisory, or supporting reference! No meaningful explanatory body
What changed, and why it matters
This commit is a routine documentation update for the Krux project. It updates the website/docs to point users to a newer version of the Krux-Installer (v0.0.21 instead of v0.0.20), fixes some broken/typoed download links and file names, and reorganizes the macOS installation instructions. There is no code change and nothing in the commit suggests a security vulnerability or malicious behavior.
Recommended action
No security action required. Treat as a normal documentation maintenance commit. Reviewers may optionally verify that the new asset names and SHA256/signature file names match the actual krux-installer v0.0.21 release artifacts, but this is a consistency check rather than a security finding.
Security signals we found
No strong security signals were identified.
Evidence from the diff
The diff only touches Markdown documentation files and the mkdocs.yml site configuration. It bumps version placeholders for the Krux-Installer from v0.0.20 to v0.0.21, corrects the RPM/DEB/Windows/macOS asset file names and the SHA256/signature file names, fixes a malformed Markdown link, merges two macOS install pages into one, and updates the navigation order. No source code, build scripts, cryptographic material, or executable files are modified.
Changed components
docs/getting-started/installing/from-gui/index.en.mddocs/getting-started/installing/from-gui/macos-arm64.en.mddocs/getting-started/installing/from-gui/macos-intel.en.mddocs/getting-started/installing/from-gui/macos.en.mddocs/getting-started/installing/from-gui/verify-download.en.mdmkdocs.ymlInspect captured patch +44 / −53
diff --git a/docs/getting-started/installing/from-gui/index.en.md b/docs/getting-started/installing/from-gui/index.en.md
index bfcb671..3ae2cca 100644
--- a/docs/getting-started/installing/from-gui/index.en.md
+++ b/docs/getting-started/installing/from-gui/index.en.md
@@ -5,10 +5,9 @@ official desktop application, **Krux-Installer**:
Install instructions:
-- [:material-fingerprint: Don't trust, verify](./verify-download.en.md)
+- [:material-fingerprint: Don't trust, verify](./verify-download.md)
- [:material-microsoft-windows: Windows](./windows.md)
-- [:material-apple: MacOS Intel](./macos-intel.md)
-- [:material-apple: MacOS M1/M2/M3](./macos-arm64.md)
+- [:material-apple: MacOS Intel or M1/M2/M3 (ARM64)](./macos.md)
- [:material-debian: Debian and like](./debian-like.md)
- [:material-fedora: Fedora and like](./fedora-like.md)
- [:material-linux: Other linux distros](./other-linux-distro.md)
diff --git a/docs/getting-started/installing/from-gui/macos-arm64.en.md b/docs/getting-started/installing/from-gui/macos-arm64.en.md
deleted file mode 100644
index 26e67ef..0000000
--- a/docs/getting-started/installing/from-gui/macos-arm64.en.md
+++ /dev/null
@@ -1,15 +0,0 @@
-# :material-apple: Download assets
-
-* [`{{latest_installer_mac_arm}}`](https://github.com/selfcustody/krux-installer/releases/download/{{latest_installer}}/{{latest_installer_mac_arm}})
-
-## Install
-
-----8<----
-install-installer-macos.en.txt
-----8<----
-
-## After install
-
-----8<----
-after-install-installer.en.txt
-----8<----
diff --git a/docs/getting-started/installing/from-gui/macos-intel.en.md b/docs/getting-started/installing/from-gui/macos-intel.en.md
deleted file mode 100644
index 4b731f1..0000000
--- a/docs/getting-started/installing/from-gui/macos-intel.en.md
+++ /dev/null
@@ -1,15 +0,0 @@
-# :material-apple: Download assets
-
-* [`{{latest_installer_mac_intel}}`](https://github.com/selfcustody/krux-installer/releases/download/{{latest_installer}}/{{latest_installer_mac_intel}})
-
-## Install
-
-----8<----
-install-installer-macos.en.txt
-----8<----
-
-## After install
-
-----8<----
-after-install-installer.en.txt
-----8<----
diff --git a/docs/getting-started/installing/from-gui/macos.en.md b/docs/getting-started/installing/from-gui/macos.en.md
new file mode 100644
index 0000000..59d927d
--- /dev/null
+++ b/docs/getting-started/installing/from-gui/macos.en.md
@@ -0,0 +1,23 @@
+# :material-apple: Download assets
+
+<!--
+**Intel**:
+
+- [`{{latest_installer_mac_intel}}`](https://github.com/selfcustody/krux-installer/releases/download/{{latest_installer}}/{{latest_installer_mac_intel}})
+-->
+
+**M1/M2/M3 (ARM64)**:
+
+- [`{{latest_installer_mac_arm}}`](https://github.com/selfcustody/krux-installer/releases/download/{{latest_installer}}/{{latest_installer_mac_arm}})
+
+## Install
+
+----8<----
+install-installer-macos.en.txt
+----8<----
+
+## After install
+
+----8<----
+after-install-installer.en.txt
+----8<----
diff --git a/docs/getting-started/installing/from-gui/verify-download.en.md b/docs/getting-started/installing/from-gui/verify-download.en.md
index 68d2f9e..ed9fbae 100644
--- a/docs/getting-started/installing/from-gui/verify-download.en.md
+++ b/docs/getting-started/installing/from-gui/verify-download.en.md
@@ -1,10 +1,10 @@
-Before start using the GUI, it's **strongly recommended** to verify the authenticity of the [{{latest_installer_sha}}](https://github.com/selfcustody/krux-installer/releases/download/{{latest_installer}}/{{latest_installer_sha}}.txt) file.
-It attest the integrity of all variants ([{{latest_installer_deb}}](https://github.com/selfcustody/krux-installer/releases/download/{{latest_installer}}/{{latest_installer_deb}}), [{{latest_installer_rpm}}]((https://github.com/selfcustody/krux-installer/releases/download/{{latest_installer}}/{{latest_installer_rpm}})), [{{latest_installer_mac_arm}}](https://github.com/selfcustody/krux-installer/releases/download/{{latest_installer}}/{{latest_installer_mac_arm}}), [{{latest_installer_win}}](https://github.com/selfcustody/krux-installer/releases/download/{{latest_installer}}/{{latest_installer_win}})).
+Before start using the GUI, it's **strongly recommended** to verify the authenticity of the [{{latest_installer_sha}}](https://github.com/selfcustody/krux-installer/releases/download/{{latest_installer}}/{{latest_installer_sha}}) file.
+It attest the integrity of all variants ([{{latest_installer_deb}}](https://github.com/selfcustody/krux-installer/releases/download/{{latest_installer}}/{{latest_installer_deb}}), [{{latest_installer_rpm}}](https://github.com/selfcustody/krux-installer/releases/download/{{latest_installer}}/{{latest_installer_rpm}}), [{{latest_installer_mac_arm}}](https://github.com/selfcustody/krux-installer/releases/download/{{latest_installer}}/{{latest_installer_mac_arm}}), [{{latest_installer_win}}](https://github.com/selfcustody/krux-installer/releases/download/{{latest_installer}}/{{latest_installer_win}})).
To do this, download two files:
-* [`{{latest_installer_sha}}`](https://github.com/selfcustody/krux-installer/releases/download/{{latest_installer}}/{{latest_installer_deb}}.sha256.txt);
-* [`{{latest_installer_sha}}.sig`](https://github.com/selfcustody/krux-installer/releases/download/{{latest_installer}}/{{latest_installer_deb}}.sig).
+* [`{{latest_installer_sha}}`](https://github.com/selfcustody/krux-installer/releases/download/{{latest_installer}}/{{latest_installer_sha}});
+* [`{{latest_installer_sig}}`](https://github.com/selfcustody/krux-installer/releases/download/{{latest_installer}}/{{latest_installer_sig}}).
## Verify the authenticity
@@ -19,7 +19,7 @@ gpg --keyserver {{latest_installer_keyserver}} --recv-keys {{latest_installer_ke
Then, to verify yourself, run this:
```bash
-gpg --verify {{latest_installer_sha}}.sig
+gpg --verify {{latest_installer_sig}}
```
**Windows**
@@ -34,7 +34,7 @@ Also, you can ignore a WARNING message if it says that the key isn't a trusted o
## Verify the integrity
-After verify that the [`{{latest_installer_sha}}`](https://github.com/selfcustody/krux-installer/releases/download/{{latest_installer}}/{{latest_installer_deb}}.sha256.txt)
+After verify that the [`{{latest_installer_sha}}`](https://github.com/selfcustody/krux-installer/releases/download/{{latest_installer}}/{{latest_installer_sha}})
is authentic, we can proceed with the integrity check in your `bash`/`zsh` terminal:
**Linux / MacOS**
@@ -48,12 +48,11 @@ sha256sum --check {{latest_installer_sha}}
You can verify the integrity with this command in a `powershell` terminal:
```pwsh
-(Get-FileHash '.\{{latest_installer_win}}' -Algorithm SHA256).Hash -ieq (
- (Select-String '.\{{latest_installer_sha}}' -Pattern (
- '^\s*([0-9a-f]{64})\s+' + [regex]::Escape((Split-Path '.\{{latest_installer_win}}' -Leaf)) + '$'
- ) | Select-Object -First 1
- ).Matches[0].Groups[1].Value
-)
+$exe = '.\{{latest_installer_win}}'
+$file = Split-Path $exe -Leaf
+
+(Get-FileHash $exe -Algorithm SHA256).Hash -eq
+(Select-String $file '.\{{latest_installer_sha}}').Line.Split()[0].ToUpper()
```
> 🛡️ TIP: If you followed the authenticity/integrity checks steps presented, you already
diff --git a/mkdocs.yml b/mkdocs.yml
index fbd584a..1d4067a 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -53,14 +53,14 @@ docs_dir: docs
site_dir: public
extra:
latest_krux: krux-v25.10.1
- latest_installer: v0.0.20
- latest_installer_rpm: krux-installer-0.0.20-1.x86_64.rpm
- latest_installer_deb: krux-installer_0.0.20_amd64.deb
- latest_installer_win: krux-installer_v0.0.20.Setup.exe
- latest_installer_mac_arm: krux-installer_0.0.20_arm64.dmg
+ latest_installer: v0.0.21
+ latest_installer_rpm: krux_installer-0.0.21-1.x86_64.rpm
+ latest_installer_deb: krux_installer_0.0.21_amd64.deb
+ latest_installer_win: krux_installer_v0.0.21_Setup.exe
+ latest_installer_mac_arm: krux_installer_0.0.21_arm64.dmg
latest_installer_mac_intel: krux-installer_0.0.20_x86_64.dmg
latest_installer_sha: krux-installer.SHA256.txt
- latest_installer_sig: krux_installer.SHA256.txt.sig
+ latest_installer_sig: krux-installer.SHA256.txt.sig
latest_installer_key: B4281DDDFBBD207BFA4113138974C90299326322
latest_installer_keyserver: hkps://keys.openpgp.org
social:
@@ -88,9 +88,9 @@ nav:
- Installing: getting-started/installing/index.en.md
- From GUI application:
- From GUI application: getting-started/installing/from-gui/index.en.md
+ - Verify: getting-started/installing/from-gui/verify-download.en.md
- Windows: getting-started/installing/from-gui/windows.en.md
- - MacOS Intel: getting-started/installing/from-gui/macos-intel.en.md
- - MacOS ARM64: getting-started/installing/from-gui/macos-arm64.en.md
+ - MacOS: getting-started/installing/from-gui/macos.en.md
- Debian-like: getting-started/installing/from-gui/debian-like.en.md
- Fedora-like: getting-started/installing/from-gui/fedora-like.en.md
- Other linux distro: getting-started/installing/from-gui/other-linux-distro.en.md
Risk score
Our methodology →Why this scored 16/100
Human-validated context
Community notes
Notes can correct, qualify, or add evidence to the AI analysis. Every note shown here has been validated by a human moderator.
No validated notes yet.
The AI analysis stands alone for now. Submit a note if you can add evidence or important context.