From 8f52e17633d8536a700011ef9bcacf72808526bb Mon Sep 17 00:00:00 2001
From: Rizel Scarlett <rizel@squareup.com>
Date: Thu, 26 Jun 2025 21:52:08 -0400
Subject: [PATCH] Update linux instructions (#3087)

---
 documentation/docs/getting-started/installation.md |  9 ++++++---
 documentation/docs/guides/updating-goose.md        | 11 +++++++----
 documentation/docs/quickstart.md                   |  8 ++++++--
 3 files changed, 19 insertions(+), 9 deletions(-)

diff --git a/documentation/docs/getting-started/installation.md b/documentation/docs/getting-started/installation.md
index 85d6353e..b246d7d8 100644
--- a/documentation/docs/getting-started/installation.md
+++ b/documentation/docs/getting-started/installation.md
@@ -90,9 +90,12 @@ import LinuxDesktopInstallButtons from '@site/src/components/LinuxDesktopInstall
         <LinuxDesktopInstallButtons/>
 
         <div style={{ marginTop: '1rem' }}>
-          1. Extract the downloaded tar.bz2 file.
-          2. Run the executable file to launch the Goose Desktop application.
-
+          **For Debian/Ubuntu-based distributions:**
+          1. Download the DEB file
+          2. Navigate to the directory where it is saved in a terminal
+          3. Run `sudo dpkg -i (filename).deb`
+          4. Launch Goose from the app menu
+          
           :::tip Updating Goose
           It's best to keep Goose updated by periodically running the installation steps again.
           :::
diff --git a/documentation/docs/guides/updating-goose.md b/documentation/docs/guides/updating-goose.md
index 8b9cc0eb..b20250fd 100644
--- a/documentation/docs/guides/updating-goose.md
+++ b/documentation/docs/guides/updating-goose.md
@@ -67,10 +67,13 @@ The Goose CLI and desktop apps are under active and continuous development. To g
         :::
         <div style={{ marginTop: '1rem' }}>
           1. <LinuxDesktopInstallButtons/>
-          2. Extract the downloaded tar.bz2 file.
-          3. Run the executable file to launch the Goose Desktop application.
-          4. Overwrite the existing Goose application with the new version.
-          5. Run the executable file to launch the Goose Desktop application.
+          
+          **For Debian/Ubuntu-based distributions:**
+          2. Download the DEB file
+          3. Navigate to the directory where it is saved in a terminal
+          4. Run `sudo dpkg -i (filename).deb`
+          5. Launch Goose from the app menu
+
         </div>
       </TabItem>
       <TabItem value="cli" label="Goose CLI">
diff --git a/documentation/docs/quickstart.md b/documentation/docs/quickstart.md
index e8a885cd..32c9cf0e 100644
--- a/documentation/docs/quickstart.md
+++ b/documentation/docs/quickstart.md
@@ -54,8 +54,12 @@ Let's begin 🚀
       <TabItem value="ui" label="Goose Desktop" default>
         <LinuxDesktopInstallButtons/>
         <div style={{ marginTop: '1rem' }}>
-          1. Extract the downloaded tar.bz2 file.
-          2. Run the executable file to launch the Goose Desktop application.
+          **For Debian/Ubuntu-based distributions:**
+          1. Download the DEB file
+          2. Navigate to the directory where it is saved in a terminal
+          3. Run `sudo dpkg -i (filename).deb`
+          4. Launch Goose from the app menu
+
         </div>
       </TabItem>
       <TabItem value="cli" label="Goose CLI">