Missing library `librealm-jni.so`

Author: clementetbCreated Mar 31, 2023Updated Oct 9, 2025

This ticket tracks any issues and developments about the SDK being unable to resolve the native library during the initialization phase.

The issue occurs when an exception is thrown while invoking Realm.init(context) with the following stacktrace:

Caused by j8.b: Could not find 'librealm-jni.so'. Looked for: [arm64-v8a, armeabi-v7a, armeabi], but only found: [].
at com.getkeepsafe.relinker.ApkLibraryInstaller.installLibrary(ApkLibraryInstaller.java:173)
at com.getkeepsafe.relinker.ReLinkerInstance.loadLibraryInternal(ReLinkerInstance.java:180)
at com.getkeepsafe.relinker.ReLinkerInstance.loadLibrary(ReLinkerInstance.java:136)
at com.getkeepsafe.relinker.ReLinker.loadLibrary(ReLinker.java:70)
at com.getkeepsafe.relinker.ReLinker.loadLibrary(ReLinker.java:57)
at io.realm.internal.RealmCore.loadLibrary(RealmCore.java:60)
at io.realm.Realm.initializeRealm(Realm.java:348)
at io.realm.Realm.init(Realm.java:263)

There is not a clear cause for it. It might be related to Relinker, or the app distributable not containing the artifacts for the device architecture.

The following issues report this same bug:

Works related to this:

https://github.com/realm/realm-java/issues/7796

Source: realm/realm-java

View original on GitHub View discussion on GitHub