Manage applications in Market

Olares Market is an open and permissionless application platform. It provides one-click installation for a variety of applications and content recommendation algorithms from both Olares and third-party developers.

This guide helps users understand how to install, update, and uninstall applications through the Market. We'll also cover how to install custom applications.

Before you begin

Before you start, it is recommended to familiarize yourself with a few concepts for Olares applications:

Terminology	Description
System application	Built-in applications that come pre-installed with Olares, such as Profile, Files, and Vault.
Community application	Applications that are created and maintained by third-party developers.
Shared application	A special category of community applications on Olares designed to provide unified, shared resources or services to all users within an Olares cluster. Only one instance is allowed per cluster.
Reference application	The applications that have been granted access to specific shared applications
Dependencies	Prerequisite applications that must already be installed before a user can access an application that requires them.

Find applications

The Olares Market offers various ways to discover and browse applications.

Browse by categories

On Discover page:

• Featured Applications: Curated by the editorial team, showcasing trending and seasonally relevant apps.
• Community choices: Most loved and recommended apps by the Olares community.
• Top apps: Apps with the highest usage and download rates.
• Latest apps: Recently added applications to the market.

You can also browse applications based on their functionality:

• Creativity: Apps for creating and publishing digital content, from AI-generated art and 3D models to blogs and design projects.
• Productivity: Apps for team collaboration, project management, data organization, and building custom AI-powered agents.
• Lifestyle: Self-hosted applications for managing your smart home, personal photo libraries, and AI identity.
• Fun: Selfhosted applications for entertainment and fun such as gaming, video streaming, and connecting with people.
• Utilities: Tools for system management, file sharing, data backup, and running local AI models.
• Developer Tools Toolchain for the software development lifecycle, including code hosting, CI/CD, observability, and database management.

Search using keywords

To search an app in the market:

1. Open the Market app from the Dock or Launchpad.
2. In the Manage sub-memu on the left, click Search.
3. Enter the keywords. The relevant results will appear as you type.

Switch market source

You can switch market sources to speed up browsing, searching, and downloading, or to install apps exclusive to a particular source. To switch market sources:

1. Open Market, and navigate to My Olares > Settings from the left sidebar.
2. Under Market sources, click Add source to add a new app source. The current official sources include:
   • Global: https://appstore-server-prod.bttcdn.com
   • China: https://appstore-china-server-prod.api.jointerminus.cn
3. Fill in the source name, URL, and description as required, then click Confirm to finish adding.
4. In the source list, select the target source to activate it. Wait for about 10 minutes for the store page to switch.

Note

Applications from different installation sources will generate corresponding tabs in My Olares for easier application management.

Install applications

To install an application from Market:

1. Open Market from Dock or Launchpad.
2. Navigate to the app you want, and click Get.
3. When the operation button changes to "Install", click it to start the installation.
4. Once finished, the button will change to "Open".

TIP

To cancel an installation, hover over the operation button and click Cancel when it appears.

Install shared and reference applications

To ensure a shared service is running and accessible within the cluster, follow this general installation process based on the type of Shared App:

• Headless backend service: This type of shared applications typically require third-party reference applications to access its service. Take Ollama for example:

  1. The administrator installs the shared application first. This makes the core service available in the cluster.

  2. Members (including the administrator) install the corresponding reference application (e.g., Open WebUI or LobeChat) to access the Ollama service.

• Complete application with built-in UI: This type of shared applications can provide service to itself. Typical examples are Dify Shared and ComfyUI Shared.

  1. The administrator installs the shared application first. This not only launches the shared service for the cluster, but also installs the client-side interface as the reference application.

     ComfyUI Launcher

     ComfyUI Shared contains a web launcher component to facilitate the management of related services and resources. The administrator needs to configure and start the service from the ComfyUI Launcher.

  2. Other members in the cluster install the same application. For these users, only the access point to the shared application is installed.

Install custom applications

To install a custom application:

1. Prepare an Olares Application Chart file (in .zip, .tgz, .tar, or .gz format).
2. Open Market from the Dock or Launchpad.
3. From the left sidebar, click My Olares > Upload custom chart, and select the chart file to install.

You can view all installed custom applications under the My Olares > Upload tab.

Update applications

To update an application from Market:

1. Open Market from the Dock or Launchpad.
2. In the left sidebar, click Updates under the Manage section. If there are available updates, a notification badge will display.
3. The Available updates panel will display the applications with available updates.Click Update all to update all applications at once, or update each application individually.

Uninstall applications

Uninstall from Market

To uninstall an application from Market:

1. Open Market from Dock or Launchpad.
2. In the left sidebar, navigate to the My Olares section. Use the source tabs to filter and find your installed applications.
3. Click keyboard_arrow_down next to the application's operation button, and select Uninstall.

Uninstall from Launchpad

You can also uninstall an application from LaunchPad:

1. In Olares, click the Launchpad icon in the Dock to display all installed apps.
2. Click and hold the app icon until all the apps begin to jiggle.
3. Click cancel on the app icon to uninstall it.

View app operation logs

The application operation log details the processes and statuses of app operations within Market, such as installation, download, update, and uninstallation. To access these logs:

1. Open Market from Dock or Launchpad.
2. In the left sidebar, navigate to My Olares.
3. Click Logs in the top right corner.

You can also click the download button to download the logs.

FAQ

Why can't I install an application?

If you can't install an application, it might be due to:

• Insufficient system resources: Try freeing up system resources, or increasing your resource quota.
• Missing dependencies: Check the Dependency section on the application details page and make sure all required apps are installed.
• Incompatible system version: Try upgrading Olares to the latest version.
• Shared application restrictions (for Olares member): Install the reference app, and contact your Olares admin to install the corresponding shared application.