mirror/LocalAI
1
0 Fork 0
mirror of https://github.com/mudler/LocalAI.git synced 2026-10-28 09:08:54 -04:00
Code Issues Packages Projects Releases Wiki Activity

feat(launcher): ship an AppImage on tagged releases (#12647)

Browse Source 
* feat(launcher): package a Linux AppImage

Ship the existing Fyne launcher as an additive release asset without
bundling the server or changing its runtime downloader.

Pin packaging tools and the type-2 runtime, preserve the caller
environment, and document the native amd64 graphics requirements.
Validate packaging contracts and wire extraction smoke checks into CI.

Assisted-by: Codex:gpt-5

* fix(launcher): harden AppImage release checks

PR builds must not receive repository write credentials. Isolate uploads
in a gated job that consumes the tested artifact without checkout.
Keep the existing release check and dependency on GoReleaser.

A surviving process does not prove that the UI event loop works.
Require observable startup progress, reject initialization errors, and
bound termination. Document the remaining limits without changing the
launcher application. Add permission and smoke failure regressions.

Assisted-by: nib:unknown

* fix(launcher): install file for AppImage builds

appimagetool fails after Go compilation when file is missing. Install
it explicitly in CI and document the local build dependency. Check for
it before compilation and cover the missing-command failure in tests.

Assisted-by: nib:unknown

---------

Co-authored-by: Ettore Di Giacinto <mudler@localai.io>
This commit is contained in:
mudler-agentandEttore Di Giacinto authored and GitHub committed 2026-10-12 17:17:43 +02:00
1 parent 98467ef0c2
commit 33459f2e2a
10 files changed
+475 -3
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

docs/content/getting-started/linux.md
+39
View File
@@ -5,6 +5,45 @@ weight: 9
url: '/installation/linux/'
---
## Desktop launcher AppImage (x86_64)
Download `LocalAI-Launcher-x86_64.AppImage` and its `.sha256` file from
[GitHub Releases](https://github.com/mudler/LocalAI/releases). In that directory:
```sh
sha256sum --check LocalAI-Launcher-x86_64.AppImage.sha256
chmod +x LocalAI-Launcher-x86_64.AppImage
./LocalAI-Launcher-x86_64.AppImage
```
You can also double-click the executable image in a file manager. Normal
AppImage mounting requires FUSE support (on Ubuntu 22.04, `libfuse2`). If FUSE
is unavailable, extract it into a writable directory and run the launcher:
```sh
./LocalAI-Launcher-x86_64.AppImage --appimage-extract
./squashfs-root/AppRun
```
This is the existing desktop/tray launcher, not the server bundled into an
image. First use needs internet access to download LocalAI. Models and backends
are downloaded separately. The launcher stores configuration in
`~/.localai/launcher.json`, runtime downloads in `~/.localai/bin`, and default
models/backends under `~/.localai/`. Fyne preferences use the user configuration
directory. These remain writable outside the read-only image. Keep your home
writable; replacing or deleting the AppImage does not delete your data.
The supported release target is **x86_64 Ubuntu 22.04 or newer**, with glibc
2.35+, OpenGL and X11 desktop libraries (XWayland on Wayland). A tray-enabled
desktop is recommended. This is not a static executable: other distributions
must provide compatible graphics libraries. ARM64 AppImages are not currently
published; use the server binaries below instead. Server/backend requirements
are separate from launcher requirements. Replace the AppImage manually to
update the launcher; there is no AppImage self-updater.
For build dependencies, pinned tools and smoke checks, see
[the AppImage build guide](https://github.com/mudler/LocalAI/blob/master/contrib/appimage/README.md).
## Manual Installation
### Download Binary