Install ossbrowser 2.0 on Windows macOS and Linux - Object Storage Service

ossbrowser 2.0 is a graphical client for managing OSS resources. This guide covers installation on Windows, macOS, and Linux.

Prerequisites

Before you begin, make sure your system meets the following requirements:

Platform	Requirement
Windows	Windows 7 or later, including Windows Server. 64-bit only.
macOS	x86_64 or arm64 architecture.
Linux (x64)	A graphical user interface (GUI) is required. Non-root user access only.

Important

On Linux, graphical subsystem dependencies may cause compatibility issues across different distributions. Use Windows or macOS for a smoother experience.

Install on Windows

Download the Windows x64 package.
Double-click the downloaded package. Select an installation directory and click Install.
On your desktop, find and double-click oss-browser2. The application interface appears.

Install on macOS

Open Terminal and run uname -m to check your processor architecture.
Download the package that matches your architecture:
- x86_64: macOS x86-64 package
- arm64: macOS arm64 package
Double-click the downloaded package.
Drag oss-browser2.app to your Applications folder.
Open Launchpad, find oss-browser2, and double-click it.
Note
macOS Gatekeeper may block the app because it was downloaded from outside the App Store. If a security warning appears, click Open to proceed. This is standard behavior for third-party applications not distributed through the App Store.
The application interface appears.

Install on Linux

Important

ossbrowser 2.0 cannot run as the root user. Log in as a non-root user before proceeding.

The following steps use Ubuntu 22.04 as an example.

Install a GUI.
Run the following commands to install a desktop environment:
```
   sudo apt-get update
   sudo apt-get install ubuntu-desktop
   reboot
```
For other Linux distributions, see Install a graphical interface on a Linux instance.
Log in as a non-root user.
After installing the GUI on an Elastic Compute Service (ECS) instance, connect to the desktop via Virtual Network Computing (VNC).

Download the package.

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

Make the AppImage executable and run it.
1. Right-click the downloaded file and select Properties.
2. Click the Permissions tab and select the checkbox to allow executing the file as a program.
3. Double-click the file. The application interface appears.
Note
If the app fails to start on Ubuntu 22.04, see Troubleshooting for the fix.

Troubleshooting

ossbrowser 2.0 won't start on Ubuntu 22.04

The Chromium sandbox inside the AppImage requires elevated permissions that the current user may not have by default.

Install AppImageLauncher, which automatically handles permission and dependency issues for AppImage applications:

# 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

After installation, launch ossbrowser 2.0 again.

Object Storage Service:Install ossbrowser 2.0