All Products
Search

This Product

    Object Storage Service:Installing ossbrowser V2.0

    Document Center

    Object Storage Service:Installing ossbrowser V2.0

    Last Updated:Jul 10, 2025

    This topic describes how to install ossbrowser V2.0 on Windows, macOS, and Linux.

    Important

    • Windows system only supports Windows 7 and later versions including Windows Server.

    • There are many Linux x64 distributions that require installation of graphical interface dependency files, so they are not recommended. We recommend that you use ossbrowser 2.0 on Windows or macOS.

    Windows system

    1. Click to download the Windows x86-64 installation package.

    2. Double-click the downloaded installation package, select the installation directory, and then click Install.

    3. Find the oss-browser2 application on the desktop and double-click it to open. The following figure shows the operations.

      image

    MacOS system

    1. Open the command line window and execute uname -m to check the system architecture. The figure shows the arm64 architecture.

      image

    2. Download the ossbrowser package that suits your processor architecture:

    3. Double-click the package to open it.

    4. Follow the instructions to drag oss-browser2.app to the Applications folder.

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

      1. Ignore the risk warning and click Open.

      2. The interface after opening is shown in the figure.

        1c5986fd7ee0d3672fbf95135c39ddda

    Linux system

    Important

    The root user cannot run ossbrowser V2.0. Please use a non-root user to log on to the system to use ossbrowser V2.0.

    The following example uses Ubuntu 22.04.

    1. Install a graphical desktop environment.

      Use the following command to install the desktop environment. For more information about how to install graphical interfaces on other Linux distributions, see Installing a graphical interface on Linux systems.

      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 the graphical interface on an ECS instance, you must restart the system and use VNC Connection to access the graphical interface of the system.

      image

    3. Download the installation package.

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

    4. Install ossbrowser V2.0.

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

        image

      2. Click Permissions and turn on the Execute switch to allow the file to be executed as a program.

        image

      3. Double-click the ossbrowser V2.0 package.

        image

    FAQ

    Ubuntu 22.04 system cannot start ossbrowser V2.0 normally

    • Issue: If you encounter the error message shown in the figure when starting ossbrowser V2.0, it is usually because the Chromium sandbox in the AppImage application requires specific permissions to run properly, and the current user does not have these permissions.

      image

    • Solution: You can evaluate and install the AppImageLauncher tool. When you start ossbrowser V2.0 again, this tool automatically resolves permission and dependency issues related to AppImage applications. The specific download and installation steps are as follows.

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

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

    What to do next

    For more information about how to log on to ossbrowser V2.0 and related configuration items, see Logging on to ossbrowser V2.0.