Reorder Linux install tabs: viam-agent first

docs/monitor/common-errors.md

@@ -104,9 +104,11 @@ This is only required for the first `ssh` connection you make to a newly-imaged
 
 **Related Error:** `dlopen(): error loading libfuse.so.2`
 
-**Description:** `viam-server` is distributed for Linux as an [AppImage](https://appimage.org/), which requires FUSE (Filesystem-in-Userspace) version 2.
-FUSE version 2 is included in almost all modern Linux distributions by default, but some older Linux distros or minimal installs might not provide it out of the box, and some newer systems may ship with FUSE version 3 installed by default, which is not compatible with `viam-server`.
-For example, the latest Raspberry Pi OS (Debian GNU/Linux 12 bookworm) includes FUSE version 3 as its default FUSE installation, and requires FUSE version 2 to be installed as well to support `viam-server`.
+**Description:** When installed manually using the AppImage binary, `viam-server` requires FUSE (Filesystem-in-Userspace) version 2.
+If you installed `viam-server` using `viam-agent` (the recommended method), you should not encounter this error.
+
+FUSE version 2 is included in almost all modern Linux distributions by default, but some older Linux distros or minimal installs might not provide it out of the box, and some newer systems may ship with FUSE version 3 installed by default, which is not compatible with the AppImage.
+For example, the latest Raspberry Pi OS (Debian GNU/Linux 12 bookworm) includes FUSE version 3 as its default FUSE installation, and requires FUSE version 2 to be installed as well.
 
 In addition, if you are installing `viam-server` within a Docker container, you may also experience this error due to its default security restrictions.
 FUSE is not required for macOS installations of `viam-server`.

docs/reference/viam-server.md

@@ -320,6 +320,15 @@ If you need to install `viam-server` without the web UI, you can run the followi
 {{< tabs >}}
 {{% tab name="Linux (Aarch64)" %}}
 {{< tabs >}}
+{{% tab name="Install using viam-agent (recommended)" %}}
+
+```sh {id="terminal-prompt" class="command-line" data-prompt="$"}
+sudo /bin/sh -c "$(curl -fsSL https://storage.googleapis.com/packages.viam.com/apps/viam-agent/install.sh)"
+```
+
+The `viam-agent` and `viam-server` binaries are installed at <FILE>/opt/viam/bin/viam-server</FILE>.
+
+{{% /tab %}}
 {{% tab name="Install manually" %}}
 
 ```bash {class="line-numbers linkable-line-numbers"}
@@ -335,7 +344,13 @@ chmod 755 viam-server && sudo ./viam-server --aix-install
 The `viam-server` binary is installed at <FILE>/usr/local/bin/viam-server</FILE>.
 
 {{% /tab %}}
-{{% tab name="Install using viam-agent" %}}
+{{< /tabs >}}
+
+{{% /tab %}}
+{{% tab name="Linux (x86_64)" %}}
+
+{{< tabs >}}
+{{% tab name="Install using viam-agent (recommended)" %}}
 
 ```sh {id="terminal-prompt" class="command-line" data-prompt="$"}
 sudo /bin/sh -c "$(curl -fsSL https://storage.googleapis.com/packages.viam.com/apps/viam-agent/install.sh)"
@@ -344,12 +359,6 @@ sudo /bin/sh -c "$(curl -fsSL https://storage.googleapis.com/packages.viam.com/a
 The `viam-agent` and `viam-server` binaries are installed at <FILE>/opt/viam/bin/viam-server</FILE>.
 
 {{% /tab %}}
-{{< /tabs >}}
-
-{{% /tab %}}
-{{% tab name="Linux (x86_64)" %}}
-
-{{< tabs >}}
 {{% tab name="Install manually" %}}
 
 ```bash {class="line-numbers linkable-line-numbers"}
@@ -364,15 +373,6 @@ chmod 755 viam-server && sudo ./viam-server --aix-install
 
 The `viam-server` binary is installed at <FILE>/usr/local/bin/viam-server</FILE>.
 
-{{% /tab %}}
-{{% tab name="Install using viam-agent" %}}
-
-```sh {id="terminal-prompt" class="command-line" data-prompt="$"}
-sudo /bin/sh -c "$(curl -fsSL https://storage.googleapis.com/packages.viam.com/apps/viam-agent/install.sh)"
-```
-
-The `viam-agent` and `viam-server` binaries are installed at <FILE>/opt/viam/bin/viam-server</FILE>.
-
 {{% /tab %}}
 {{< /tabs >}}
 {{% /tab %}}