From 8fa247c3ba3690cc944d41b52654ffeb51995c2c Mon Sep 17 00:00:00 2001
From: bradleyJT-CS <73871918+bradleyJT-CS@users.noreply.github.com>
Date: Wed, 4 Jun 2025 13:02:49 -0700
Subject: [PATCH] steamos-{boot-install, devmode, finalize-install},
 mount.steamos: add pages (#16750)

Co-authored-by: Managor <42655600+Managor@users.noreply.github.com>
Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com>
Co-authored-by: K.B.Dharun Krishna <kbdharunkrishna@gmail.com>
---
 pages/linux/mount.steamos.md            | 20 ++++++++++++++++++++
 pages/linux/steamos-boot-install.md     |  7 +++++++
 pages/linux/steamos-devmode.md          | 17 +++++++++++++++++
 pages/linux/steamos-finalize-install.md | 24 ++++++++++++++++++++++++
 4 files changed, 68 insertions(+)
 create mode 100644 pages/linux/mount.steamos.md
 create mode 100644 pages/linux/steamos-boot-install.md
 create mode 100644 pages/linux/steamos-devmode.md
 create mode 100644 pages/linux/steamos-finalize-install.md

diff --git a/pages/linux/mount.steamos.md b/pages/linux/mount.steamos.md
new file mode 100644
index 0000000000..266f951473
--- /dev/null
+++ b/pages/linux/mount.steamos.md
@@ -0,0 +1,20 @@
+# mount.steamos
+
+> Mount or unmount SteamOS filesystem partitions.
+> More information: <https://gitlab.com/users/evlaV/projects>.
+
+- Mount all necessary partitions from a device to a target directory:
+
+`sudo mount.steamos {{/dev/sdX}} {{/mnt}}`
+
+- Mount with options to exclude specific partitions (e.g. `/home`, overlays):
+
+`sudo mount.steamos {{[-o|--options]}} nohome,nooverlay {{/dev/sdX}} {{/mnt}}`
+
+- Unmount all partitions mounted under a target directory:
+
+`sudo mount.steamos -u {{/mnt}}`
+
+- Display help:
+
+`mount.steamos {{[-h|--help]}}`
diff --git a/pages/linux/steamos-boot-install.md b/pages/linux/steamos-boot-install.md
new file mode 100644
index 0000000000..e139a8ad04
--- /dev/null
+++ b/pages/linux/steamos-boot-install.md
@@ -0,0 +1,7 @@
+# steamos-boot-install
+
+> This command is an alias of `steamos-finalize-install`.
+
+- View documentation for the original command:
+
+`tldr steamos-finalize-install`
diff --git a/pages/linux/steamos-devmode.md b/pages/linux/steamos-devmode.md
new file mode 100644
index 0000000000..42091db549
--- /dev/null
+++ b/pages/linux/steamos-devmode.md
@@ -0,0 +1,17 @@
+# steamos-devmode
+
+> Enable SteamOS developer mode.
+> Note: Developer mode disables read-only protections and initializes the package manager.
+> More information: <https://gitlab.com/users/evlaV/projects>.
+
+- Enable developer mode:
+
+`sudo steamos-devmode enable`
+
+- Enable developer mode without confirmation prompt:
+
+`sudo steamos-devmode enable --no-prompt`
+
+- Check if developer mode is currently enabled:
+
+`sudo steamos-devmode status`
diff --git a/pages/linux/steamos-finalize-install.md b/pages/linux/steamos-finalize-install.md
new file mode 100644
index 0000000000..3485c1a044
--- /dev/null
+++ b/pages/linux/steamos-finalize-install.md
@@ -0,0 +1,24 @@
+# steamos-finalize-install
+
+> Complete a SteamOS installation by setting up bootloaders and applying system updates.
+> More information: <https://gitlab.com/users/evlaV/projects>.
+
+- Finalize the installation:
+
+`sudo steamos-finalize-install`
+
+- Finalize without updating bootloaders or kernel:
+
+`sudo steamos-finalize-install --no-bootloaders --no-kernel`
+
+- Skip all migration steps:
+
+`sudo steamos-finalize-install --no-migrate`
+
+- Set a specific root hash during finalization:
+
+`sudo steamos-finalize-install --roothash {{hash}}`
+
+- Force system migration steps regardless of environment:
+
+`sudo steamos-finalize-install --force`