Deployment Quick Start

Start a single node cluster for testing, learning, or development.

This page will walk you through starting a single node Synnax cluster. To get started, select your operating system below:

Linux

MacOS

Windows

Docker

Using Linux

To start a single node cluster on Linux, first download the latest Synnax binary by running:

curl -LO github.com/synnaxlabs/synnax/releases/download/synnax-v0.40.1/synnax-v0.40.1-linux

Then, move the binary to /usr/local/bin:

sudo mv synnax-v0.40.1-linux /usr/local/bin/synnax

Next, give execution permissions to the binary:

chmod +x /usr/local/bin/synnax

You’ll need to make sure that /usr/local/bin is in your PATH environment variable. You can do this temporarily by running export PATH=$PATH:/usr/local/bin.

Finally, start the node:

synnax start --listen=localhost:9090 --mem --insecure

This will start a single node cluster with the following parameters:

--listen=localhost:9090 - This sets the address that the node will listen on. This is the reachable address of the node, and is also the address that other nodes will use to connect when deploying a multi-node cluster.

--mem - Tells the node to store all data in memory, which is useful for learning and development.

--insecure - Tells the node to run without TLS.

If you’re interested in more details on these flags, see the CLI Reference.

To stop the node, simply press Ctrl+C in the terminal.