●Change8

Migrating to LocalAI v3.9.0

Version v3.9.0 introduces 2 breaking changes. This guide details how to update your code.

Released: 12/24/2025

2
Breaking Changes
3
Migration Steps
4
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

/readyz/healthzStableDiffusion-GGMLsingle_active_backend

Breaking Changes

●Issue #1

Data storage path has been updated from /usr/share to /var/lib to follow Linux conventions for mutable data. Users relying on the old path for configuration or data access must update their paths.

●Issue #2

x86_64 Mac support has been dropped and is no longer maintained in GitHub Actions. Users on x86_64 Macs should migrate to ARM64 architecture.

Migration Steps

  1. 1
    If you were relying on data stored in the old path (/usr/share), update your configuration or scripts to point to the new path (/var/lib).
  2. 2
    Users on x86_64 Macs should plan to migrate to ARM64 architecture as x86_64 support is discontinued.
  3. 3
    If using the single_active_backend mode, note that it now defaults to LRU=1 for backward compatibility.

Release Summary

LocalAI 3.9.0 introduces significant stability and resource management features, including an Agent Jobs panel for scheduling and an automatic Smart Memory Reclaimer with LRU model eviction. This release also drops x86_64 Mac support and updates data storage paths.

Need More Details?

View the full release notes and all changes for LocalAI v3.9.0.

View Full Changelog