From b7cd4228f2f4727e894a96c9912b55a70d19bb95 Mon Sep 17 00:00:00 2001 From: Metbcy Date: Thu, 21 May 2026 08:24:45 +0000 Subject: [PATCH] docs(prerequisites): note about static libs for Alpine/musl builds Alpine Linux uses musl, which links system libraries statically by default. Building Tauri apps there commonly fails at the linker step even after installing all the recommended -dev packages, because the corresponding *-static packages aren't installed. Document the additional apk packages that resolve the most common cases, with a heads-up that not every Tauri dependency ships as *-static on Alpine. Refs #12296 (tauri-apps/tauri) --- src/content/docs/start/prerequisites.mdx | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/src/content/docs/start/prerequisites.mdx b/src/content/docs/start/prerequisites.mdx index d92aeebf63..d3db0ee5a9 100644 --- a/src/content/docs/start/prerequisites.mdx +++ b/src/content/docs/start/prerequisites.mdx @@ -136,6 +136,20 @@ sudo apk add \ > Note: Alpine Linux containers don’t include any fonts by default. To ensure text renders correctly in your Tauri app, install at least one font package (for example, `font-dejavu `). +> Note: Alpine targets the musl C library, so Rust builds link a number of system libraries statically. If `cargo`/`pnpm tauri build` fails with linker errors for symbols from libraries that `pkg-config` reports as present, install the matching `*-static` packages alongside the `-dev` ones above: +> +> ```sh +> sudo apk add --no-cache \ +> openssl-libs-static \ +> cairo-static \ +> harfbuzz-static \ +> glib-static \ +> wayland-static \ +> zlib-static +> ``` +> +> Not every dependency Tauri pulls in is packaged as `*-static` on Alpine; in those cases you may need to build the missing static library from source. +