Skip to content

docs(prerequisites): note about static libs for Alpine/musl builds #3840

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Metbcy wants to merge 1 commit into
base: v2
Choose a base branch
from
Open

docs(prerequisites): note about static libs for Alpine/musl builds #3840

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 14 additions & 0 deletions src/content/docs/start/prerequisites.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.

</TabItem>
<TabItem label="NixOS">

Expand Down
Loading