diff --git a/docs/monitor/common-errors.md b/docs/monitor/common-errors.md index b13fa083c8..20a1be062b 100644 --- a/docs/monitor/common-errors.md +++ b/docs/monitor/common-errors.md @@ -104,16 +104,17 @@ 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:** On 32-bit ARM Linux (armhf), `viam-server` is distributed as an [AppImage](https://appimage.org/), which requires FUSE (Filesystem-in-Userspace) version 2. +On 64-bit Linux (aarch64, x86_64) and macOS, install `viam-server` using [`viam-agent`](/reference/viam-agent/) instead. You will not encounter this error with `viam-agent`. + +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`. {{% alert title="Important" color="note" %}} -`viam-server` requires FUSE version 2 (`libfuse2`), _not_ FUSE version 3 (`fuse3` or `libfuse3`) or versions of FUSE previous to FUSE version 2 (`fuse`). -To support a `viam-server` installation, you must install `libfuse2`. +The AppImage requires FUSE version 2 (`libfuse2`), _not_ FUSE version 3 (`fuse3` or `libfuse3`) or versions of FUSE previous to FUSE version 2 (`fuse`). +To resolve this error, you must install `libfuse2`. {{% /alert %}} **Solution:** If you receive this error, install FUSE version 2 on your Linux system according to one of the following steps: diff --git a/docs/reference/device-setup/jetson-agx-orin-setup.md b/docs/reference/device-setup/jetson-agx-orin-setup.md index 82ca4edbb3..daa085ecca 100644 --- a/docs/reference/device-setup/jetson-agx-orin-setup.md +++ b/docs/reference/device-setup/jetson-agx-orin-setup.md @@ -78,11 +78,9 @@ If you intend to use GPIO, however, we recommend installing Jetpack 5 on your Je Look at the Troubleshooting section below for help navigating these instructions. Once you have reached _Next Steps_, return to the Viam docs. -{{< alert title="Tip: viam-server installation with curl" color="tip" >}} +{{< alert title="Tip: curl installation" color="tip" >}} -If `curl` is not installed on your Orin, run `sudo apt install curl` before downloading the `viam-server` binary. - -If this command fails, try using `wget https://storage.googleapis.com/packages.viam.com/apps/viam-server/viam-server-latest-aarch64.AppImage` to download the `viam-server` binary. +If `curl` is not installed on your Orin, run `sudo apt install curl` before proceeding with installation. {{% /alert %}} @@ -150,9 +148,7 @@ To use your Jetson board, follow the [setup guide](/set-up-a-machine/first-machi ### Install `curl` -If `curl` is not installed on your Orin, run `sudo apt install curl` before downloading the `viam-server` binary. - -If this command fails, try using `wget https://storage.googleapis.com/packages.viam.com/apps/viam-server/viam-server-stable-aarch64.AppImage` to download the `viam-server` binary. +If `curl` is not installed on your Orin, run `sudo apt install curl` before proceeding with installation. You can find additional assistance in the [Troubleshooting section](/monitor/troubleshoot/). diff --git a/docs/reference/device-setup/jetson-nano-setup.md b/docs/reference/device-setup/jetson-nano-setup.md index 2de3e3a74e..43c420717b 100644 --- a/docs/reference/device-setup/jetson-nano-setup.md +++ b/docs/reference/device-setup/jetson-nano-setup.md @@ -109,9 +109,7 @@ To use your Jetson board, follow the [setup guide](/set-up-a-machine/first-machi ### Install `curl` -If `curl` is not installed on your Orin, run `sudo apt install curl` before downloading the `viam-server` binary. - -If this command fails, try using `wget https://storage.googleapis.com/packages.viam.com/apps/viam-server/viam-server-stable-aarch64.AppImage` to download the `viam-server` binary. +If `curl` is not installed on your Nano, run `sudo apt install curl` before proceeding with installation. ### Barrel jack power supply polarity diff --git a/docs/reference/viam-server.md b/docs/reference/viam-server.md index e4e7f23205..c1377f379f 100644 --- a/docs/reference/viam-server.md +++ b/docs/reference/viam-server.md @@ -319,23 +319,6 @@ 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 manually" %}} - -```bash {class="line-numbers linkable-line-numbers"} -curl https://storage.googleapis.com/packages.viam.com/apps/viam-server/viam-server-stable-aarch64.AppImage -o viam-server -``` - -Next, to make the `viam-server` executable and install as a system service, run the following command: - -```bash {class="line-numbers linkable-line-numbers"} -chmod 755 viam-server && sudo ./viam-server --aix-install -``` - -The `viam-server` binary is installed at /usr/local/bin/viam-server. - -{{% /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)" @@ -343,38 +326,15 @@ sudo /bin/sh -c "$(curl -fsSL https://storage.googleapis.com/packages.viam.com/a The `viam-agent` and `viam-server` binaries are installed at /opt/viam/bin/viam-server. -{{% /tab %}} -{{< /tabs >}} - {{% /tab %}} {{% tab name="Linux (x86_64)" %}} -{{< tabs >}} -{{% tab name="Install manually" %}} - -```bash {class="line-numbers linkable-line-numbers"} -curl https://storage.googleapis.com/packages.viam.com/apps/viam-server/viam-server-stable-x86_64.AppImage -o viam-server -``` - -Next, to make the `viam-server` executable and install as a system service, run the following command: - -```bash {class="line-numbers linkable-line-numbers"} -chmod 755 viam-server && sudo ./viam-server --aix-install -``` - -The `viam-server` binary is installed at /usr/local/bin/viam-server. - -{{% /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 /opt/viam/bin/viam-server. -{{% /tab %}} -{{< /tabs >}} {{% /tab %}} {{% tab name="macOS" %}} diff --git a/static/include/install/architectures.md b/static/include/install/architectures.md index dd4c84b11c..5b05be23fd 100644 --- a/static/include/install/architectures.md +++ b/static/include/install/architectures.md @@ -2,19 +2,15 @@ {{% tab name="Aarch64"%}} ```sh {class="command-line" data-prompt="$"} -curl https://storage.googleapis.com/packages.viam.com/apps/viam-server/viam-server-stable-aarch64.AppImage -o viam-server && chmod 755 viam-server && sudo ./viam-server --aix-install +sudo /bin/sh -c "$(curl -fsSL https://storage.googleapis.com/packages.viam.com/apps/viam-agent/install.sh)" ``` -You can also use the latest version with [https://storage.googleapis.com/packages.viam.com/apps/viam-server/viam-server-latest-aarch64.AppImage](https://storage.googleapis.com/packages.viam.com/apps/viam-server/viam-server-latest-aarch64.AppImage). - {{% /tab %}} {{% tab name="X86_64"%}} ```sh {class="command-line" data-prompt="$"} -curl https://storage.googleapis.com/packages.viam.com/apps/viam-server/viam-server-stable-x86_64.AppImage -o viam-server && chmod 755 viam-server && sudo ./viam-server --aix-install +sudo /bin/sh -c "$(curl -fsSL https://storage.googleapis.com/packages.viam.com/apps/viam-agent/install.sh)" ``` -You can also use the latest version with [https://storage.googleapis.com/packages.viam.com/apps/viam-server/viam-server-stable-x86_64.AppImage](https://storage.googleapis.com/packages.viam.com/apps/viam-server/viam-server-stable-x86_64.AppImage). - {{% /tab %}} {{< /tabs >}}