FiftyOne DeviceDetection error in .NET 8, alphine platform

[koattila]

Hi,
We were using DeviceDetection for Debian platform before, and there was no problem so far, but when we switched to Alphine image, we are getting the same error, when trying create the provider file.

[EROR] 51Degrees: Unable to create provider from data file '/app-server-efs/51degrees/Enterprise-HashV41.hash' System.Exception: Failed to load the Device Detection native library, common causes include: - Missing dependencies: o On Windows, the Visual C++ runtime is not installed, see the Visual Studio download page for the latest C++ Redistributable: https://visualstudio.microsoft.com/downloads/ o On Linux, the libatomic shared object is missing. On Debian based distributions, run ‘apt install libatomic1’; on RedHat based distributions, run ‘<yum|dnf> install libatomic’. - The DLL file was not copied to the output directory during build, refer to the ‘System.DllNotFoundException’ inner exception for the exact library file name. - The incorrect DLL was copied to the output directory, this maybe be caused by the build chain determining the incorrect platform or the incorrect platform has been specified in the build process. If using the dotnet command, see https://docs.microsoft.com/en-us/dotnet/core/rid-catalog to specify the correct runtime. If using Visual Studio, make sure the selected Platform (x86/x64) matches your environment. - If building for .NET Framework, the AnyCPU configuration is not supported, make sure to build for the required Platform (x86/x64). - Your environment may not be among the ones we automatically test and build packages for. You can check the list of tested environments at: https://51degrees.com/documentation/4.4/_info__tested_versions.html. If your environment isn't listed or you are using a unique virtual environment e.g. running on Mac CPUs, in such cases, we recommend compiling the C code specifically for your target environment. This does not rule out the potential compatibility with other environments, but implies that the packages may not have been specifically built for them. ---> System.TypeInitializationException: The type initializer for 'FiftyOne.DeviceDetection.Hash.Engine.OnPremise.Interop.DeviceDetectionHashEngineModulePINVOKE' threw an exception. ---> System.TypeInitializationException: The type initializer for 'SWIGExceptionHelper' threw an exception. ---> System.DllNotFoundException: Unable to load shared library 'FiftyOne.DeviceDetection.Hash.Engine.OnPremise.Native.dll' or one of its dependencies. In order to help diagnose loading problems, consider using a tool like strace. If you're using glibc, consider setting the LD_DEBUG environment variable: Error loading shared library /app/runtimes/linux-x64/native/FiftyOne.DeviceDetection.Hash.Engine.OnPremise.Native.dll.so: No such file or directory Error loading shared library /usr/share/dotnet/shared/Microsoft.NETCore.App/8.0.8/FiftyOne.DeviceDetection.Hash.Engine.OnPremise.Native.dll.so: No such file or directory Error loading shared library /app/FiftyOne.DeviceDetection.Hash.Engine.OnPremise.Native.dll.so: No such file or directory Error loading shared library FiftyOne.DeviceDetection.Hash.Engine.OnPremise.Native.dll.so: No such file or directory Error loading shared library /app/runtimes/linux-x64/native/libFiftyOne.DeviceDetection.Hash.Engine.OnPremise.Native.dll.so: No such file or directory Error loading shared library /usr/share/dotnet/shared/Microsoft.NETCore.App/8.0.8/libFiftyOne.DeviceDetection.Hash.Engine.OnPremise.Native.dll.so: No such file or directory Error loading shared library /app/libFiftyOne.DeviceDetection.Hash.Engine.OnPremise.Native.dll.so: No such file or directory Error loading shared library libFiftyOne.DeviceDetection.Hash.Engine.OnPremise.Native.dll.so: No such file or directory Error loading shared library libatomic.so.1: No such file or directory (needed by /app/runtimes/linux-x64/native/FiftyOne.DeviceDetection.Hash.Engine.OnPremise.Native.dll) Error loading shared library /usr/share/dotnet/shared/Microsoft.NETCore.App/8.0.8/FiftyOne.DeviceDetection.Hash.Engine.OnPremise.Native.dll: No such file or directory Error loading shared library /app/FiftyOne.DeviceDetection.Hash.Engine.OnPremise.Native.dll: No such file or directory Error loading shared library FiftyOne.DeviceDetection.Hash.Engine.OnPremise.Native.dll: No such file or directory Error loading shared library /app/runtimes/linux-x64/native/libFiftyOne.DeviceDetection.Hash.Engine.OnPremise.Native.dll: No such file or directory Error loading shared library /usr/share/dotnet/shared/Microsoft.NETCore.App/8.0.8/libFiftyOne.DeviceDetection.Hash.Engine.OnPremise.Native.dll: No such file or directory Error loading shared library /app/libFiftyOne.DeviceDetection.Hash.Engine.OnPremise.Native.dll: No such file or directory Error loading shared library libFiftyOne.DeviceDetection.Hash.Engine.OnPremise.Native.dll: No such file or directory

Does FiftyOneDegree support Alphine images ? We do have Libatomic installed in the new image runtime
RUN apk add libatomic

[koattila]

SDK image is
8.0.407-alpine3.20
RUNTIME image is
8.0.8-alpine3.20

[justadreamer]

Hi @koattila
Thank you for bringing this up. As a side-effect of this we have enhanced the exception error message to be a bit more generic. Alpine Linux distro is not among the ones we build for and test on (we test on Ubuntu 20.04, 22.04, 24.04 distributions) and while the packages provide a certain level of compatibility with different Linux environments - they are not guaranteed to run on those we don't explicitly tested on.

The reason this not running in your case is not the libatomic library dependency, but rather libc dependency. Alpine uses musl while we built against glibc. Alpine has a glibc-compat package, but we haven't explicitly tested running against it - not sure if it works with binaries built against glibc.

In such cases we do recommend building from source in the target environment: https://github.com/51Degrees/device-detection-dotnet?tab=readme-ov-file#build-from-source - this instruction has an example for Ubuntu, so you will need to adapt to building on Alpine. Hope this helps.

[koattila]

Hi @justadreamer,
Thank you for your response.
Since there's not an easy solution, we deprioritize it for now and come back to it in 1-2 weeks and see if it works.
Don't close the ticket please, we might have questions later.

[rbeattie-ssi]

The error message points to https://51degrees.com/documentation/4.4/_info__tested_versions.html which says that Alpine is one of the tested versions. But you said only test on Ubuntu. Should the documentation be updated or is it related to other testing?

[justadreamer]

Hi @rbeattie-ssi thanks for pointing this out. It looks like the title "Tested versions" may cause some confusion. The text however has it correct that the library will operate on Alpine Linux as well as many other Linux distributions, however the tested OS versions are actually listed in the tabs in the bottom for each language. In case of .NET these are:

In general 51Degrees has a CI/CD policy to automatically test the packages prior to the release on the Standard GitHub runners. GitHub Linux images are represented by Ubuntu distributions.

[justadreamer]

Hi guys, were you able to compile the library for Alpine Linux from source?