Installing

NATS philosophy is simplicity.

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:

  1. > brew install nats-streaming-server

Via Docker:

  1. > docker pull nats-streaming

Installing a release build

You can find the latest release of nats-streaming-server here.

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:

  1. > curl -L https://github.com/nats-io/nats-streaming-server/releases/download/v0.14.2/nats-streaming-server-v0.14.2-linux-amd64.zip -o nats-streaming-server.zip
  2. > unzip nats-streaming-server.zip -d tmp
  3. Archive: nats-streaming-server.zip
  4. creating: tmp/nats-streaming-server-v0.14.2-linux-amd64/
  5. inflating: tmp/nats-streaming-server-v0.14.2-linux-amd64/README.md
  6. inflating: tmp/nats-streaming-server-v0.14.2-linux-amd64/LICENSE
  7. inflating: tmp/nats-streaming-server-v0.14.2-linux-amd64/nats-streaming-server
  8. > cp tmp/nats-streaming-server-v0.14.2-linux-amd64/nats-streaming-server /usr/local/bin

Installing from the source

If you have go installed, installing the binary is easy:

  1. > 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:

  1. go test -v -p=1 ./...

Some of the store tests require a SQL server to be running. To skip those, use this command instead:

  1. go test -v -p=1 ./... -sql=false

Testing Your Installation

To test your installation (provided the executable is visible to your shell):

  1. > nats-streaming-server
  2. [58061] 2019/05/22 13:56:45.463562 [INF] STREAM: Starting nats-streaming-server[test-cluster] version 0.14.2
  3. [58061] 2019/05/22 13:56:45.463639 [INF] STREAM: ServerID: Avb51sMf9imRPVVwv6Ts0v
  4. [58061] 2019/05/22 13:56:45.463657 [INF] STREAM: Go version: go1.11.10
  5. [58061] 2019/05/22 13:56:45.463659 [INF] STREAM: Git commit: [not set]
  6. [58061] 2019/05/22 13:56:45.464086 [INF] Starting nats-server version 1.4.1
  7. [58061] 2019/05/22 13:56:45.464092 [INF] Git commit [not set]
  8. [58061] 2019/05/22 13:56:45.464310 [INF] Listening for client connections on 0.0.0.0:4222
  9. [58061] 2019/05/22 13:56:45.464328 [INF] Server is ready
  10. [58061] 2019/05/22 13:56:45.495045 [INF] STREAM: Recovering the state...
  11. [58061] 2019/05/22 13:56:45.495055 [INF] STREAM: No recovered state
  12. [58061] 2019/05/22 13:56:45.749604 [INF] STREAM: Message store is MEMORY
  13. [58061] 2019/05/22 13:56:45.749658 [INF] STREAM: ---------- Store Limits ----------
  14. [58061] 2019/05/22 13:56:45.749664 [INF] STREAM: Channels: 100 *
  15. [58061] 2019/05/22 13:56:45.749668 [INF] STREAM: --------- Channels Limits --------
  16. [58061] 2019/05/22 13:56:45.749671 [INF] STREAM: Subscriptions: 1000 *
  17. [58061] 2019/05/22 13:56:45.749675 [INF] STREAM: Messages : 1000000 *
  18. [58061] 2019/05/22 13:56:45.749678 [INF] STREAM: Bytes : 976.56 MB *
  19. [58061] 2019/05/22 13:56:45.749682 [INF] STREAM: Age : unlimited *
  20. [58061] 2019/05/22 13:56:45.749686 [INF] STREAM: Inactivity : unlimited *
  21. [58061] 2019/05/22 13:56:45.749690 [INF] STREAM: ----------------------------------