Skip to content
Open
Show file tree
Hide file tree
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
51 changes: 38 additions & 13 deletions docs/manual/olares/market/market.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,6 @@ The Olares Market offers various ways to discover and browse applications.

![Market](/images/manual/olares/market-discover1.png#bordered)


### Browse by categories

Upon launching the Market app, the **Discover** page serves as your central hub for exploration, organizing content into intuitive sections to guide your journey:
Expand All @@ -37,10 +36,10 @@ Upon launching the Market app, the **Discover** page serves as your central hub
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.
* **Developer Tools**: Toolchain for the software development lifecycle, including code hosting, CI/CD, observability, and database management.
* **Fun**: Self-hosted applications for entertainment and fun such as gaming, video streaming, and connecting with people.
* **Fun**: Self-hosted applications for entertainment and fun such as gaming, video streaming, and connecting with people.
* **Lifestyle**: Self-hosted applications for managing your smart home, personal photo libraries, and AI identity.
* **Utilities**: Tools for system management, file sharing, data backup, and running local AI models.
* **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.
* **AI**: Latest open-source LLMs and generative tools for text, audio, and 3D assets.

### Search using keywords
Expand All @@ -51,17 +50,17 @@ To search an app in the market:
2. In the **Manage** submenu on the left, click **Search**.
3. Enter the keywords. The relevant results will appear as you type.

![Search app](/images/manual/olares/search-app.png#bordered)
![Search app](/images/manual/olares/search-app.png#bordered)

### 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:
You can switch market sources to speed up browsing, searching, and downloading, or to install apps exclusive to a particular source.

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

:::info
Expand All @@ -72,11 +71,21 @@ Applications from different installation sources will generate corresponding tab

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. (Optional) To cancel the installation, click <i class="material-symbols-outlined">close_small</i> on the right of the button.
5. Once finished, the button will change to **Open**.
1. Open Market from the Dock or Launchpad.
2. Find your target application, and double-click it to view its details.
3. If the application supports multiple hardware accelerators, configure your deployment in the **RESOURCES** section:

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would it be better to add a screenshot here to show the RESOURCES section?

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

yes will add one when the ui is ready


a. Select your preferred computing resource from the drop-down list. For example, **NVIDIA GPU**, **NVIDIA GB10**, or **CPU**.

<!--![Accelerator resources](/images/manual/olares/market-accelerator.png#bordered)-->

b. Review the updated **CPU**, **Memory**, **Required disk**, and **VRAM** requirements, and make sure your hardware meets these requirements.
Comment thread
Power-One-2025 marked this conversation as resolved.
Outdated

4. Click **Get**.
5. When the operation button changes to **Install**, click it.
6. If prompted, confirm your hardware accelerator choice. The installation starts.
7. (Optional) To cancel the installation, click <i class="material-symbols-outlined">close_small</i> on the right of the button.
8. When the installation finishes, the button changes to **Open**.

### Install shared applications

Expand Down Expand Up @@ -188,6 +197,22 @@ You can also click the <i class="material-symbols-outlined">download</i> button

## FAQs

### Errors in the RESOURCES section

Before you install an application, the system evaluates your current hardware and cluster capacity. If your environment does not meet the selected configuration, an inline error message will appear directly inside the **RESOURCES** panel:

- "Unable to install. The Olares cluster does not have any required accelerator specified."

The application requires specific computing hardware that is not installed or detected on your device or cluster. When this happens, the resource drop-down will display **N/A**, and the unsupported hardware options will be greyed out and unselectable.

- "Unable to install on this accelerator type. Not enough required {Resource} on Olares cluster."

Your system possesses the correct hardware type (e.g., an NVIDIA GPU), but its currently available capacity (such as GPU memory) is insufficient to run the app. You must stop other running applications to free up the required resources for this specific accelerator.
Comment thread
Power-One-2025 marked this conversation as resolved.
Outdated

- "Unable to install. Not enough required {Resource} available on your quota."

Your personal account's assigned resource limit (e.g., CPU or Memory) has been reached. Try freeing up your allocated resources by stopping your unused apps, or contact your administrator to request a quota increase.
Comment thread
Power-One-2025 marked this conversation as resolved.
Outdated

### 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.
Expand Down
50 changes: 40 additions & 10 deletions docs/zh/manual/olares/market/market.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,23 +35,23 @@ Olares **应用市场**提供多种方式发现和浏览应用。
你还可以根据功能浏览应用:
* **设计创作**:用于创建和发布数字内容的应用程序,包括 AI 生成的艺术、3D 模型、博客和设计项目。
* **工作效率**:用于团队协作、项目管理、数据组织和构建自定义 AI 代理的应用。
* **开发工具**:软件开发生命周期的工具链,包括代码托管、CI/CD、可观察性和数据库管理。
* **休闲娱乐**:用于娱乐和休闲的自托管应用程序,如游戏、视频流媒体和社交。
* **生活方式**:用于管理智能家居、个人照片库和 AI 身份的自托管应用。
* **实用工具**:用于系统管理、文件共享、数据备份和运行本地 AI 模型的工具。
* **开发工具**:软件开发生命周期的工具链,包括代码托管、CI/CD、可观察性和数据库管理。
* **AI**:最新的开源大语言模型(LLMs),以及涵盖文本、音频和 3D 资产生成的 AI 创作工具。

### 使用关键词搜索

要在市场中搜索应用:
![搜索 app](/images/manual/olares/search-app.png#bordered)

1. 在左侧的**管理**子菜单中,点击**搜索**。
2. 输入关键词。相关结果将随你在输入时显示。

![搜索应用](/images/manual/olares/search-app.png#bordered)

### 切换应用源

您可以选择不同的应用商店源,以加快浏览、搜索和下载应用的速度,或者安装某些源特有的应用。要切换应用源:
你可以选择不同的应用商店源,以加快浏览、搜索和下载应用的速度,或者安装某些源特有的应用。要切换应用源:
1. 打开**应用市场**,从左侧导航栏进入**我的 Olares** > **设置**。
2. 在**市场来源**下,点击**添加源**以添加新的应用源。当前 Olares 官方源包括:
- 国际源:https://api.olares.com/market
Expand All @@ -65,10 +65,23 @@ Olares **应用市场**提供多种方式发现和浏览应用。

## 安装应用

1. 打开**应用市场**,找到所需应用,点击**获取**。
2. 当操作按钮变为**安装**时,点击以开始安装。
3. 若要取消安装,点击按钮右侧的 <i class="material-symbols-outlined">close_small</i>。
4. 安装完成后,按钮将变为**打开**。
要从应用市场安装应用:

1. 从应用坞或启动台,打开**应用市场**。
2. 找到目标应用,双击查看其详情。
3. 如果该应用支持多种硬件加速器,在**资源**区域配置部署信息:

a. 从下拉列表中选择所需的计算资源。例如 **NVIDIA GPU**、**NVIDIA GB10** 或 **CPU**。

<!--![Accelerator resources](/images/zh/manual/olares/market-accelerator.png#bordered)-->

b. 查看动态更新后的 **CPU**、**内存**、**所需磁盘空间** 和 **显存** 要求,确保你的硬件满足这些条件。
Comment thread
Power-One-2025 marked this conversation as resolved.
Outdated

4. 点击**获取**。
5. 当操作按钮变为**安装**时,点击**安装**。
6. 如果弹出提示,点击**确认**以确认你的硬件加速器选择。安装开始。
7. (可选)若要取消安装,点击按钮右侧的 <i class="material-symbols-outlined">close_small</i>。
8. 安装完成后,按钮将变为**打开**。

### 安装共享应用

Expand Down Expand Up @@ -96,7 +109,7 @@ Olares **应用市场**提供多种方式发现和浏览应用。
### 安装自定义应用

1. 准备 Olares 应用 Chart 文件(格式为 `.zip`、`.tgz`、`.tar` 或 `.gz`)。
2. 打开应用市场,从左侧菜单进入**我的 Olares**。
2. 打开**应用市场**,从左侧菜单进入**我的 Olares**。
3. 点击右上角**上传自定义 Chart**并选择 Chart 文件以安装。

你可以在**上传**页签查看并管理所有本地自定义应用。
Expand All @@ -112,6 +125,7 @@ Olares **应用市场**提供多种方式发现和浏览应用。
完成设置后可点击继续安装。

## 更新应用

从应用市场下载的应用可按以下步骤获取更新:

1. 打开**应用市场**。
Expand Down Expand Up @@ -140,7 +154,7 @@ Olares **应用市场**提供多种方式发现和浏览应用。
</template>
<template #从启动台卸载>

1. 在 Olares 中,点击 Dock 中的启动台图标,显示所有已安装应用。
1. 在 Olares 中,点击应用坞中的启动台图标,显示所有已安装应用。
Comment thread
Power-One-2025 marked this conversation as resolved.
Outdated
2. 点击并按住应用图标,直到所有应用开始抖动。
3. 点击应用图标上的 <i class="material-symbols-outlined">cancel</i>。
4. 在弹出的**卸载**窗口中,根据情况选择如下选项:
Expand Down Expand Up @@ -176,6 +190,22 @@ Olares **应用市场**提供多种方式发现和浏览应用。
* **系统版本不兼容**:尝试将 Olares 升级到最新版本。
* **共享应用依赖**(对于 Olares 成员):该应用需要集群中已运行某个共享服务。请联系管理员先安装相应的共享应用,然后你才能安装此应用。

### 资源区域报错

在安装应用之前,系统会评估你当前的硬件和集群容量。如果你的环境不满足所选配置,**资源**面板内会直接显示错误信息:

- “无法安装。Olares 集群未配置所需的加速器。”

该应用需要特定的计算硬件,但你的设备或集群上未安装或未检测到相应硬件。出现这种情况时,资源下拉列表会显示 **N/A**,不支持的硬件选项将呈灰色且无法选择。

- “Olares 集群上{资源}不足,无法安装到指定类型的加速器上。”

你的系统拥有正确的硬件类型(例如 NVIDIA GPU),但其当前可用容量(如 GPU 显存)不足以运行该应用。你必须停止其他正在运行的应用,以释放该加速器所需的资源。

- “无法安装。你的{资源}可用配额不足。”

你的个人账户已用完分配的资源限额(例如 CPU 或 Memory)。尝试停止不使用的应用以释放分配的资源,或联系管理员申请增加配额。

### 为什么应用处于停止状态?

应用停止运行通常是由于以下原因之一:
Expand Down