Skip to content

livekit 1.1.3: liblivekit_ffi.so fails to load on arm64 Docker (Bookworm) — undefined symbol __arm_tpidr2_save #591

@onur-yildirim-infinitusai

Description

Description

livekit==1.1.3 fails to load liblivekit_ffi.so when running in a linux/arm64 Docker container based on Debian Bookworm (python:3.11-slim-bookworm). The native library references __arm_tpidr2_save, which is not available in the Bookworm glibc.

This is the same class of issue as AGT-2075 (glibc symbol incompatibility), but with a different symbol on arm64.

Environment

  • Host: macOS on Apple Silicon (arm64)
  • Docker image: python:3.11-slim-bookworm (linux/arm64)
  • livekit version: 1.1.3
  • livekit-agents version: 1.5.1

Error

File "/workspace/.venv/lib/python3.11/site-packages/livekit/rtc/_ffi_client.py", line 228, in __init__
    raise ImportError(
ImportError: failed to load liblivekit_ffi.so:
/workspace/.venv/lib/python3.11/site-packages/livekit/rtc/resources/liblivekit_ffi.so: undefined symbol: __arm_tpidr2_save
Install the livekit package with: pip install livekit
Or set LIVEKIT_LIB_PATH to the path of the native library.

Steps to reproduce

  1. On an Apple Silicon Mac, build a Docker image using python:3.11-slim-bookworm as base (defaults to linux/arm64)
  2. Install livekit==1.1.3
  3. Import livekit or run any command that triggers FfiClient initialization

Workaround

Building with --platform linux/amd64 (x86 emulation via Rosetta) avoids the issue.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions