All Products
Search

This Product

    Object Storage Service:Install ossbrowser 2.0

    Document Center

    Object Storage Service:Install ossbrowser 2.0

    Last Updated:Dec 18, 2025

    This article explains how to install ossbrowser 2.0 on Windows, macOS, and Linux.

    Important

    • Only Windows 7 and later versions including Windows Server are supported.

    • OSSbrowser 2.0 requires graphical subsystem dependencies on Linux x64 distributions. Due to potential compatibility issues across diverse Linux environments, we recommend Windows or macOS platforms for optimal performance.

    Install on Windows

    1. Download the Windows x64 package.

    2. Double-click the downloaded package. Select an installation directory and click Install.

    3. On your desktop, find and double-click the oss-browser2 application. The application interface appears.

      ossbrowser 2.0 on Windows

    Install on macOS

    1. Open Terminal and run uname -m to determine your processor architecture. The output in the figure indicates an arm64 architecture.

      uname command output on macOS

    2. Download the package that matches your processor architecture:

    3. Double-click the downloaded package.

    4. Drag the oss-browser2.app file to your Applications folder.

    5. Open Launchpad, find the oss-browser2 application, and double-click it.

      1. If a security warning appears, click Open.

      2. The application interface appears.

        ossbrowser 2.0 on macOS

    Install on Linux

    Important

    ossbrowser 2.0 cannot be run as the root user. You must log on to the system as a non-root user.

    The following example uses Ubuntu 22.04.

    1. Install a graphical user interface (GUI).

      Run the following commands to install a GUI. For instructions on other Linux distributions, see Install a graphical interface on a Linux instance.

      sudo apt-get update
sudo apt-get install ubuntu-desktop
reboot

    2. Log on to the system as a non-root user.

      After you install a GUI on an Elastic Compute Service (ECS) instance, you must reboot the system and connect to the GUI by using VNC.

      VNC login screen on Linux

    3. Download the package.

      wget https://gosspublic.alicdn.com/oss-browser2-prod/2.1.1/oss-browser2-linux-x86_64-2.1.1.AppImage

    4. Install ossbrowser 2.0.

      1. Right-click the downloaded package and click Properties.

        Properties option in context menu

      2. Click the Permissions tab and select the checkbox to allow executing the file as a program.

        Permissions tab in file properties

      3. Double-click the ossbrowser 2.0 package to open it. The application interface appears.

        ossbrowser 2.0 on Linux

    Troubleshooting

    Cannot start ossbrowser 2.0 on Ubuntu 22.04

    • Possible cause: When you start ossbrowser 2.0, you may encounter the error message shown in the figure. This issue occurs because the Chromium sandbox within the AppImage application requires permissions that the current user lacks.

      Chromium sandbox error

    • Resolution: Install the AppImageLauncher tool, which automatically resolves permission and dependency issues for AppImage applications. The following steps show how to download and install it.

      # Download AppImageLauncher
sudo wget https://github.com/TheAssassin/AppImageLauncher/releases/download/v2.2.0/appimagelauncher_2.2.0-travis995.0f91801.bionic_amd64.deb

# Install AppImageLauncher
sudo apt install ./appimagelauncher_2.2.0-travis995.0f91801.bionic_amd64.deb

    Next steps

    To learn how to log on to ossbrowser 2.0 and configure its settings, see Log on to ossbrowser 2.0.