Installation

Use the following command to install the NSec.Cryptography NuGet package:

$ dotnet add package NSec.Cryptography --version 25.3.0-preview.4

Supported Platforms

NSec 25.3.0-preview.4 is intended to run on all supported versions of .NET on the following platforms:

	`-x64`	`-x86`	`-arm64`	`-arm`
`android-`
`ios-`			✓
`linux-`	✓		✓	✓
`linux-musl-`	✓		✓	✓
`maccatalyst-`	✓		✓
`osx-`	✓		✓
`tvos-`			✓
`win-`	✓	✓	✓

Please note:

On Windows, the Microsoft Visual C++ Redistributable for Visual Studio 2015, 2017, 2019, and 2022 is required. This is part of Visual Studio and the .NET SDK but might not be present on a clean Windows installation.
The AES-GCM implementation in NSec is hardware-accelerated and may not be available on all architectures. Support can be determined at runtime using the static IsSupported property of the NSec.Cryptography.Aes256Gcm class.

Tested Platforms

NSec 25.3.0-preview.4 has been tested to run on the following platforms and .NET versions:

OS	Version	Architecture	.NET
Windows 11	23H2	x64	9.0.3 / 8.0.14
Windows Server 2022	LTSC	x64	9.0.3 / 8.0.14

macOS	13.7	x64	9.0.3 / 8.0.14
	14.7	arm64	9.0.3 / 8.0.14
	15.2	arm64	9.0.3 / 8.0.14

Alpine Linux	3.20	x64	9.0.3
	3.21	x64	9.0.3
Debian	12	x64	9.0.3 / 8.0.14
Fedora	40	x64	9.0.3 / 8.0.14
	41	x64	9.0.3 / 8.0.14
Ubuntu	22.04	x64	9.0.3 / 8.0.14
	24.04	x64	9.0.3 / 8.0.14

The other supported platforms should work as well, but have not been tested.

Frequently Asked Questions

Below are some frequently asked questions:

Q: What causes a System.DllNotFoundException: Unable to load shared library ‘libsodium’ or one of its dependencies. when using the NSec.Cryptography NuGet package?
A: This exception can occur if the operating system or architecture is not supported, or if the Visual C++ Redistributable has not been installed on a Windows system. Please refer to the Supported Platforms section above.