Olares

English

简体中文

English

简体中文

Appearance

What to do after updating to Olares 1.12.6 ​

Olares 1.12.6 introduces several architecture and workflow changes.

This guide explains which existing apps and workflows changed in 1.12.6, whether you need to take action, and where to find the detailed steps.

Before app migration

Open the app-specific migration guide and back up or export the data it identifies. When uninstalling an old app, carefully consider whether to select Also remove all local data. This option can permanently delete models, workflows, settings, or other app data.

Find what applies to you ​

If this applies to youWhat to do
You installed an app marked as a shared app before Olares 1.12.6You can keep using the v2 version. To use the new version, check its migration guide before uninstalling it. View migration options.
An AI app installed before 1.12.6 does not start after the updateBack up any app data you need, uninstall the affected app, then install the latest compatible version from Market. Learn more.
You use standalone OllamaNo immediate action is needed. Use Ollama Engine Base when deploying new models. See how.
You use Sonarr, Radarr, Prowlarr, or a separate download clientUpdate any connection URLs and paths affected by Olares 1.12.6. See what changed.
You previously used StudioUse the current Agent Skills and app submission guides. View the replacement docs.

Manage v2 shared apps installed before Olares 1.12.6 ​

To identify an affected app, open its Market page and look for a Shared or Shared app label, or the group icon.

Before Olares 1.12.6, a shared app consisted of a server component and a client-side access point. This documentation refers to apps that use this architecture as v2 shared apps. In 1.12.6, the new architecture replaces these components with a single shared service managed by the administrator. For details, see Shared applications.

After you update Olares to 1.12.6, installed v2 shared apps continue to work at their current versions but cannot be updated. You do not need to take action if you want to keep the current version.

A v2 shared app and its new-architecture counterpart cannot be installed side by side. To use the new version, uninstall the v2 app and install the new version from Market. Because uninstalling an app can remove its data, choose the appropriate migration path below before you begin.

  • Preserve local data: For ComfyUI, uninstall the old app without removing local data, then install the new version. Follow the ComfyUI migration notes.
  • Follow an app-specific migration: Use the dedicated guide for Dify, OnlyOffice, SearXNG, or Xinference. The data that can be preserved differs by app.
  • Reinstall directly: Use this path only for an app that has no user-created data to migrate. Check Perform a clean reinstallation for the current guidance.
  • Apps installed from uploaded packages: If you installed a v2 shared app from an uploaded package, use the Olares CLI Agent Skills to have your agent retrieve the package, update it for the new shared-app architecture, and reinstall it. Before uninstalling the old app, make sure the agent identifies and preserves any data you need.

Move from standalone Ollama to Engine Base ​

Starting with Olares 1.12.6, the standalone Ollama app is no longer available in Market. Existing installations keep working, but you cannot update the app from Market.

For new deployments, use Ollama Engine Base:

  1. Deploy the model using the Ollama Engine Base.
  2. Open the model in Model Console, then copy its Base URL for connecting client apps.
  3. Reconfigure the clients that used the standalone Ollama endpoint.

See Run local AI models with Engine Base apps for the complete setup.

Replace Studio with the new app development workflow ​

Studio was an Olares app for building, porting, packaging, and testing applications in a real Olares environment. It is no longer available in Market, and its documentation has been retired.

Use these guides for the replacement workflow:

Other changes that might affect you ​

AI apps that fail to start ​

Some AI apps installed before 1.12.6 might not start after the update. If an app is affected, uninstall it and install the latest compatible version from Market. No further action is needed if you already reinstalled it during the 1.12.6 release candidate.

Before uninstalling an app with user-created data, follow its migration guide and preserve the data it identifies.

*Arr apps and download clients ​

Olares 1.12.6 changes two parts of the *Arr setup:

  • Connections: *Arr apps now communicate through internal entrance URLs instead of provider URLs.
  • Paths: *Arr apps and download clients now use a unified mount structure.

Update the affected URLs and paths by following Update notes for *Arr apps. If you use a separate download client, also check Update notes for download clients.

Optional: Enable automatic startup on Olares One ​

The Automatic startup toggle is available under Settings > My Olares > My Hardware. It starts Olares One automatically when power is connected or restored.

The feature requires Olares OS 1.12.6 or later and embedded controller (EC) firmware 1.03 or later. If the requirement is not met, the toggle remains disabled. See Manage BIOS and EC to check or update the EC firmware.

Learn more ​