This page has detailed information on how to build NSS. Because NSS is a cross-platform library that builds on many different platforms and has many options, it may be complex to build. Please read these instructions carefully before attempting to build.
NSS needs a C and C++ compiler. It has minimal dependencies, including only standard C and C++ libraries, plus zlib.
NSS compilation on Windows uses the same shared build system as Mozilla Firefox. You must first install the Windows Prerequisites, including MozillaBuild.
You can also build NSS on the Windows Subsystem for Linux, but the resulting binaries aren't usable by other Windows applications.
NSS and NSPR use Mercurial for source control like other Mozilla projects. To check out the latest sources for NSS and NSPR--which may not be part of a stable release--use the following commands:
hg clone https://hg.mozilla.org/projects/nspr hg clone https://hg.mozilla.org/projects/nss
To get the source of a specific release, see NSS Releases.
Build NSS using our build script:
This builds both NSPR and NSS.
Alternatively, there is a
make target called "nss_build_all", which produces a similar result. This supports some alternative options, but can be a lot slower.
make -C nss nss_build_all USE_64=1
The make-based build system for NSS uses a variety of variables to control the build. Below are some of the variables, along with possible values they may be set to.
- Build a debug (non-optimized) version of NSS. This is the default.
- Build an optimized (non-debug) version of NSS.
- Build for a 32-bit environment/ABI. This is the default.
- Build for a 64-bit environment/ABI. This is recommended.
- Do not create an AddressSanitizer build. This is the default.
- Create an AddressSanitizer build.
NSS contains extensive unit tests. Scripts to run these are found in the
tests directory. Run the standard suite by:
HOST=localhost DOMSUF=localdomain USE_64=1 nss/tests/all.sh
NSS tests are configured using environment variables.
The scripts will attempt to infer values for
DOMSUF, but can fail. Replace
localdomain with the hostname and domain suffix for your host. You need to be able to connect to
If you don't have a domain suffix you can add an entry to
/etc/hosts (on Windows,
c:\Windows\System32\drivers\etc\hosts) as follows:
Validate this opening a command shell and typing:
USE_64=1 override if using a 32-bit build.
Running all tests can take a considerable amount of time.
Test output is stored in
tests_results/security/$HOST.$NUMBER/. The file
results.html summarizes the results,
output.log captures all the test output.
Other subdirectories of
nss/tests contain scripts that run a subset of the full suite. Those can be run directly instead of
all.sh, which might save some time at the cost of coverage.