The best way to get the NATS Streaming Server is to use one of the pre-built release binaries which are available for OSX, Linux (x86-64/ARM), Windows.
Of course you can build the latest version of the server from the master branch. The master branch will always build and pass tests, but may not work correctly in your environment. First you will need at least Go version 1.11+ installed on your machine to build the NATS Streaming Server.
Installation is just decompressing a zip file and copying the binary to an appropriate directory; you can also use your favorite package manager.
Installing via a Package Manager
On Mac OS:
> brew install nats-streaming-server
Via Docker:
> docker pull nats-streaming
Installing a release build
You can find the latest release of nats-streaming-server .
Download the zip file matching your systems architecture, and unzip. For this example, assuming version 0.14.2 of the server, and a Linux AMD64:
If you have go installed, installing the binary is easy:
> go get github.com/nats-io/nats-streaming-server
This mechanism will install a build of master, which almost certainly will not be a released version. If you are a developer and want to play with the latest, this is the easiest way of obtaining it.
You can run the test suite from the nats-streaming-server root directory:
go test -v -p=1 ./...
Some of the store tests require a SQL server to be running. To skip those, use this command instead:
go test -v -p=1 ./... -sql=false
Testing Your Installation
To test your installation (provided the executable is visible to your shell):