Olares Files

We are grateful to the Olares community for your feedback and support in shaping this release. We are excited to announce Olares v1.12.5 is released!🎉 This release introduces NVIDIA DGX Spark support and ships a wave of improvements across system reliability, app management, hardware compatibility, and UI experience.

Highlights

• DGX Spark Support: Added support for NVIDIA DGX Spark, expanding compatibility for high-performance AI workloads.(#2496 @eball)

See the installation guide for details.

• Kickstarter Backers Recognition: Added a dedicated Olares One Kickstarter Backer thank-you list in Settings, giving our early supporters a prominent thank-you note within the product. (#2573 @qq815776412)
• Client/Server App Memory Handling: Improved stop and cleanup handling for client/server apps, ensuring memory is released after the app stops. (#2708 @icebergtsn)
• Installation Reliability
• Improved installation reliability with time synchronization checks, resolving activation failures caused by timezone mismatches. (#2616 @eball)
• Improved DNS handling in complex network environments, including cases with DHCP-assigned search domains that can affect system activation. (#2707 @dkeven)
• Connection Stability
• Improved connection stability by preventing unnecessary proxy reloads from interrupting active TCP/UDP sessions. (#2556 @eball)
• Addressed intermittent Steam network disconnections. (#2556 @eball)
• GPU Management
• Refined GPU resource management end-to-end and added support for manifest-defined GPU memory settings. (#2581, #2660 @eball)
• Improved GPU switching behavior and made GPU information display more consistent across Settings and app details. (#2524, #2661 @qq815776412)
• Enhanced GPU scheduling to account for workload placement constraints. (#2653 @dkeven)

See the GPU management documentation for details.

Enhancements

Settings, Desktop & UI

• Improved overall UI consistency across apps, with refinements to font styling, backgrounds, animations, notification controls, and selected wording and localization details. (#2463 @icebergtsn, #2464 @eball, #2554, #2643 @ethanwheatthin, #2691 @qq815776412)
• Improved toasts and prompts for uploads, integrations, and app scheduling-related events. (#2520, #2563 @qq815776412, #2688 @icebergtsn)
• Enhanced app status notifications with application icons and alerts when apps pause due to insufficient GPU memory. (#2692 @qq815776412)
• Added SMB account management in Settings and improved environment variable management. (#2456 @icebergtsn)
• Relocated the "Sign out" function from Desktop to Settings to centralize system-level actions. (#2433 @qq815776412)

Apps & Resource Management

• Added an option to delete app data during uninstall for cleaner removal and reinstallation. (#2479 @hysyeah, #2485 @icebergtsn)
• Added app icon metadata to NATS events for better app identification in related flows. (#2476 @hysyeah)
• Restricted delete and rename actions for AI-related folders. (#2515 @qq815776412)

System, Networking & Security

• Improved external access controls by allowing external network access to be turned on or off and keeping related access URLs in sync. (#2540 @eball)
• Improved SMB service compatibility for minikube-based installations on macOS. (#2460 @dkeven)
• Unified external IP detection through a shared system configuration, improving consistency across components. (#2613, #2614 @dkeven)
• Enhanced TOTP sign-in protection with temporary lockouts after repeated failed attempts. (#2466, #2518 @eball)
• Enhanced troubleshooting support by collecting more system logs and increasing default log limits. (#2429, #2505 @dkeven)
• Improved device status checking by avoiding false failures when IP change checks encounter errors. (#2701 @eball)
• Improved download handling and progress reporting in the download server. (#2490, #2657 @kaki-admin)

Hardware & Runtime

• Improved GPU device plugin reliability by avoiding startup aborts when devices are temporarily unavailable. (#2671 @dkeven)
• Improved USB device mounting reliability by adapting mount behavior based on filesystem type. (#2596 @eball)
• Improved USB device detection reliability by increasing retry handling while waiting for partition information. (#2620 @eball)
• Improved startup reliability by ensuring key services wait for network readiness. (#2603 @eball)

Bug Fixes

• Fixed file upload issues, including interruptions, folder upload failures, and problems with overly long file names. (#2520, #2563, #2623 @qq815776412, #2708 @icebergtsn)
• Fixed incorrect file sorting and issues opening files from Desktop search. (#2504 @icebergtsn)
• Fixed data and display issues related to GPU information and app details in Settings, along with resource calculation issues in Market. (#2634 @qq815776412, #2642 @icebergtsn, #2652 @eball)
• Fixed an issue where clicking an already opened app in Desktop could trigger an unexpected refresh. (#2634 @qq815776412)
• Fixed handling of system apps without configuration in permission APIs and provider-related flows. (#2500, #2509 @eball)
• Fixed a race condition between app upgrades and environment updates that could lead to inconsistent app states. (#2594 @dkeven)
• Fixed multi-user custom domain issues for apps. (#2599 @aby913)
• Fixed issues where two-factor access policies were not applied correctly in some cases. (#2601 @eball)
• Fixed file sync instability during uploads by refining retry handling and reducing upload failures. (#2689 @lovehunter9)
• Fixed unnecessary waiting when starting or resuming apps with unschedulable GPU workloads. (#2533, #2699 @hysyeah)
• Fixed readiness checks by ignoring finished pods that do not affect system functionality. (#2528 @dkeven)
• Fixed Control Hub permissions to ensure users only access authorized multi-user resource chart data. (#2708 @icebergtsn)
• Fixed Seafile syncing issues by trimming the commit ID and updating database initialization logic. (#2494 @lovehunter9)
• Fixed a potential system daemon hang caused by delays when opening PCAP handles. (#2439 @eball)
• Fixed CLI dmesg log collection by correctly separating command arguments. (#2497 @dkeven)
• Fixed chart repository rendering failures when uploading application packages. (#2714 @aby913)
• Fixed HAMI scheduler compatibility with fast app stop behavior to prevent scheduling conflicts. (#2712, #2715 @dkeven)
• Fixed market app resume behavior for stopped applications. (#2698 @aby913)

How to Update to v1.12.5

[!IMPORTANT] Upgrade your LarePass to the latest version (1.9.20) from your app store first.

[!NOTE] No action is required when upgrading from v1.12.4. If upgrading from v1.12.3 or earlier, you must restart all AI applications that use the GPU to ensure they function correctly.

1. Open the LarePass app, and navigate to Settings > System > System update.
2. Verify that a new version is available and tap Upgrade.
3. Choose an upgrade method and tap Confirm.
4. When prompted, tap Continue to start installation.
5. When the update is complete, you can see a success message in LarePass confirming the update is complete.
6. Manually refresh your Olares desktop to sync the latest updates.

What's Changed

• settings, market, files, vault, desktop: fix some ui bugs by @icebergtsn in #2504
• app-service: handle case for system apps without configuration in permission API by @eball in #2500
• fix: seafile trim commit_id for syncing and change psql ccnet init by @lovehunter9 in #2494
• backup: sync systemEnv default value by @aby913 in #2493
• download-server: feat download server modify by @kaki-admin in #2490
• market, settings: support optional data deletion and fix bugs. by @icebergtsn in #2485
• feat: refactor permission parsing to use exported function and update related calls by @hysyeah in #2487
• fix: app uninstall delete data by @hysyeah in #2479
• appservice: fix add spec ports by @hysyeah in #2477
• feat: add icon filed to nats event by @hysyeah in #2476
• desktop, settings, files, vault: fix multiple known issues by @icebergtsn in #2467
• authelia: add user regulation for TOTP authentication attempts by @eball in #2466
• settings, user service: update wallpaper style by @icebergtsn in #2463
• bfl: enhance user login background handling with style support by @eball in #2464
• settings: add settings new version and update provider api by @icebergtsn in #2456
• l4: skip invalid expose port by @hysyeah in #2441
• daemon: change pcap open timeout to 1 millisecond to prevent close hang by @eball in #2439
• feat(olares-app): update version to v1.8.2 by @qq815776412 in #2433
• bfl: myapps api add rawAppName by @hysyeah in #2432
• cli: upgrade l4-bfl-proxy to v0.3.10 by @hysyeah in #2442
• fix(cli): seperate dmesg args for dmesg logs by @dkeven in #2497
• feat(cli): add more lines to default journalctl limit by @dkeven in #2505
• fix(cli): set node port range in minikube to allow smb service by @dkeven in #2460
• feat(cli): collect nginx logs stored temporarily in some containers by @dkeven in #2429
• docs: add OpenClaw tutorial by @Power-One-2025 in #2506
• appservice: handle case for system applications without configuration in provider list by @eball in #2509
• bfl: remove deprecated ingress mode handling from NginxController by @eball in #2511
• docs: fix sunshine address for .local domain and formatting for olares one docs by @fnalways in #2512
• olares-app: update version to v1.9.1 by @qq815776412 in #2515
• docs: update instructions per latest operations for OpenClaw by @Power-One-2025 in #2517
• authelia: add auth type param to user regulation by @eball in #2518
• olares-app: update version to v1.9.2 by @qq815776412 in #2520
• docs: add skills and plugins management for OpenClaw by @Power-One-2025 in #2521
• olares-app: update version to v1.9.3 by @qq815776412 in #2524
• docs: resolve comments on managing apps by @Power-One-2025 in #2523
• docs: add SMB account management to Settings by @Power-One-2025 in #2526
• fix(cli): ignore finished pods in readiness check by @dkeven in #2528
• appservice: stop app if it is hami cause unschedule no wait by @hysyeah in #2533
• bfl: add sync urls to master node by @eball in #2540
• docs: update content related to reference app by @Power-One-2025 in #2530
• l4-bfl-proxy: skip nginx reload if configuration has not changed by @eball in #2556
• cli: upgrade l4-bfl-proxy to v0.3.11 by @hysyeah in #2557
• docs: update custom domain tutorial screenshots and align copy with latest UI by @fnalways in #2559
• olares app: Use the Roboto font to match the theme of the rest of the applications by @ethanwheatthin in #2554
• docs: fix space nav display, extract use-case/developer sidebars, add note in space docs by @fnalways in #2562
• docs: update method for installing drivers on windows by @Power-One-2025 in #2564
• feat(olares-app): update olares-app version to v1.9.5 by @qq815776412 in #2563
• docs: updates for releasing resources and uninstalling shared apps by @Power-One-2025 in #2568
• docs: add troubleshooting guide for memory not released after stopping apps by @fnalways in #2565
• docs: update the initialization steps for OpenClaw tutorial by @Power-One-2025 in #2567
• docs: update installation method of drivers on windows by @Power-One-2025 in #2566
• feat(olares-app): update olares-app version to v1.9.6 by @qq815776412 in #2573
• docs: add troubleshooting guide for missing apps in Market by @fnalways in #2574
• fix: conditionally install storage for juicefs by @dkeven in #2579
• docs: revamp the "Advanced" page (previously "Developer") by @Power-One-2025 in #2534
• app-service: support injecting gpu memory and container selection by @eball in #2581
• cli, daemon: enhance DGX Spark support and update GPU type handling by @eball in #2496
• docs: add factory reset via BIOS and reinstall via USB by @fnalways in #2576
• docs: add how to check SSH password in vault by @fnalways in #2571
• docs: fix & streamline ssh access by @fnalways in #2584
• docs: fix model name used in tutorial by @TShentu in #2582
• docs: update Windows local access steps & tidy wording by @fnalways in #2587
• fix: add kubeblocks addon chart image to manifest by @hysyeah in #2590
• fix(cli): dynamic creation of nvidia runtimeclass by @dkeven in #2591
• ci: change cdn backend storage to cos by @eball in #2592
• docs: updated wise and desktop docs by @Meow33 in #2586
• fix(appservice): avoid race condition between upgrade & applyenv by @dkeven in #2594
• daemon: enhance USB device mounting by dynamically setting options based on filesystem type by @eball in #2596
• l4-bfl-proxy: fix multi users app custom domain by @aby913 in #2599
• system frontend: fix system app launch and display bugs. by @icebergtsn in #2600
• authelia: fix bug of sub-policy failed if set it to two-factor by @eball in #2601
• cli: update etcd service template to use network-online.target by @eball in #2603
• docs: restructure factory reset and reinstall docs for Olares One by @fnalways in #2607
• docs: fix broken shields images and architecture link in README by @jeremiahlee in #2608
• docs: add persona setup for OpenClaw tutorial by @Power-One-2025 in #2605
• feat(daemon): use unified remote api env to query external ip by @dkeven in #2613
• feat(bfl): use unified remote api env to query external ip by @dkeven in #2614
• feat(cli): add time synchronization check using chronyc by @eball in #2616
• docs: update Olares Manifest to 0.11.0 by @TShentu in #2527
• fix(daemon): increase retry count for USB device detection by @eball in #2620
• fix(manifest): add password reset path for cli in auth provider by @dkeven in #2622
• feat(olares-app): update version to v1.9.12 by @qq815776412 in #2623
• docs: add manual restart instructions and refine discord channel config by @Power-One-2025 in #2617
• fix(bfl): remove set custom domain on cloudflare by @aby913 in #2624
• docs: add LarePass VPN troubleshooting docs by @fnalways in #2606
• fix(cli): remove error logging for GB10 chip check by @eball in #2626
• docs: update UI and screenshots for Windows VM by @Meow33 in #2612
• docs: generalize Olares Space Basic redemption instructions for broader audience by @Power-One-2025 in #2627
• docs: add application environment variables by @Meow33 in #2577
• fix(bfl): update l4 version by @aby913 in #2629
• authelia: update bridge builder to accept pointer to configuration by @eball in #2631
• docs: add remote ssh steps for Olares One by @fnalways in #2621
• fix(daemon): improve host IP validation and error handling in CheckCurrentStatus by @eball in #2632
• fix(cli): clear master host config when preparing by @dkeven in #2633
• feat(olares-app): update version to v1.9.13 by @qq815776412 in #2634
• docs: add troubleshooting guide for system error in LarePass by @Meow33 in #2618
• docs: add troubleshooting topic for network not ready by @Power-One-2025 in #2636
• docs: add known issue for initial setup failure at 9% by @Power-One-2025 in #2639
• docs: update shields images and architecture link in README by @Meow33 in #2637
• docs: add ZH version for troubleshooting topic by @Power-One-2025 in #2641
• docs: refactor and update OpenClaw tutorial by @Power-One-2025 in #2645
• olares-app: pointer cursor on market carousel, clear all notification button by @ethanwheatthin in #2643
• docs: fix olares uninstall command by @fnalways in #2649
• settings: fix backer data error, hide GPU page single model switch & add refresh by @icebergtsn in #2642
• olares: update init-check host values to use full domain in deployment configurations by @eball in #2647
• feat(olares-app): update version to v1.9.15 by @qq815776412 in #2650
• daemon: replace CPU info retrieval with a new utility function by @eball in #2652
• fix(gpu): consider other node constraints when scheduling pod by @dkeven in #2653
• fix: occasional invalid format because of assert column type failed by @lovehunter9 in #2655
• docs: update Open WebUI guides with revised model setup workflows by @fnalways in #2656
• appservice: include selected GPU type in app configuration during upgrade by @eball in #2660
• olares-app: update olares-app version to v1.9.18 by @qq815776412 in #2661
• download-server: fix download progress issue by @kaki-admin in #2657
• fix(cli): trim bash warning if output needs to be unmarshalled by @dkeven in #2665
• fix(cli): do not provide version option for upgrade commands by @dkeven in #2666
• docs: clean up reusables by @fnalways in #2668
• docs: update GPU compatibility for CUDA 13.1 and standardize installation guides by @fnalways in #2604
• docs: add reference link by @Power-One-2025 in #2669
• docs: add FAQs for redeem membership by @Power-One-2025 in #2667
• docs: revamp LobeHub tutorial by @Power-One-2025 in #2648
• fix: remove sync upload flooded logs and correct a sync upload log in files by @lovehunter9 in #2674
• fix(gpu): do not abort plugin start in case no device is found by @dkeven in #2671
• docs: align Appearance and network access policy with latest UI updates by @Meow33 in #2536
• docs: update UI labels in app uninstallation and stop for consistency by @Power-One-2025 in #2578
• docs: add note that reset password is saved to Vault by @Meow33 in #2659
• docs: comment out Wise and extension by @Power-One-2025 in #2675
• docs: restructure Steam direct play docs by @fnalways in #2678
• docs: update use cases nav by @fnalways in #2677
• docs: update GPU mode docs by @Meow33 in #2651
• docs: comment out wise by @fnalways in #2680
• fix: files rpc connection pool, and limit sync previews to 10 by @lovehunter9 in #2684
• market, desktop: show prompt when HDMI scheduling fails after app restart. by @icebergtsn in #2688
• fix: files sync unstable by scale pool size from 5 to 45, add additional retry for upload, and fix a retry bug in upload chunk by @lovehunter9 in #2689
• fix(olares-app): update version to v1.9.22 by @qq815776412 in #2691
• market: fix resume stopped status by @aby913 in #2698
• feat(notifications): update new version to v1.12.41 by @qq815776412 in #2692
• docs: update dual-boot Windows doc to improve user experience by @fnalways in #2682
• appservice: stop app fast if pod was hami schudule failed when resume by @hysyeah in #2699
• docs: update commands for storage expansion by @Meow33 in #2696
• docs: update troubleshooting guide for system error in LarePass by @Meow33 in #2693
• market, desktop, settings, control hub, file: fix multi-user resource chart permissions in control-hub, unify CS app stop & uninstall operations and fix folder upload failure by @icebergtsn in #2708
• fix(tapr): dont forward local search domain inside cluster DNS by @dkeven in #2707
• fix: simplify IP change check and improve error handling by @eball in #2701
• chartrepo: update apps required fields by @aby913 in #2706
• docs: add connect AI apps tutorial by @fnalways in #2630
• docs: batch review recent updated docs by @fnalways in #2679
• docs: Create SECURITY.md by @pengpeng in #2713
• fix(hami-scheduler): compatible with app's stop fast behavior by @dkeven in #2712
• chartrepo: resolve rendering failure for uploaded package by @aby913 in #2714
• fix(appservice): capture dedicated event to stop app fast in lack of GPU by @dkeven in #2715
• olares-app, login: release new version to v1.9.25 by @qq815776412 in #2716

New Contributors

A big thank you to our new contributors who made their first contribution to Olares in this release!

• @jeremiahlee fixed broken shield badges and an architecture link in the README in #2608
• @ethanwheatthin updated the Olares app to use the Roboto font for visual consistency in #2554, and fixed the pointer cursor on the market carousel and the clear-all notification button in #2643

Welcome to the project! 🎉