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:
Using Docker
The simplest way to start a single node cluster is by using the
synnaxlabs/synnax Docker image, simply run:
docker run -p 9090:9090 synnaxlabs/synnax --listen=localhost:9090 --mem --insecureThis will pull the latest version of Synnax from Docker Hub and start a single node cluster with the following parameters:
-p 9090:9090 - This maps port 9090 on the host to port 9090 in the container.
This allows access to the Synnax node from the host machine.
--listen=localhost:9090 - This sets the address that the node will listen on.
This is the reachable adress 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.
Using Windows
Download Synnax v for Windows
Releases for other operating systems and older versions can be found on the releases page.
To start the node, run this command in a PowerShell terminal:
synnax start --listen=localhost:9090 --mem --insecureThis 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.
The cluster CLI Reference contains more details about these flags.
To stop the node, simply press Ctrl+C in the terminal.
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.38.1/synnax-v0.38.1-linuxThen, move the binary to /usr/local/bin:
sudo mv synnax-v0.38.1-linux /usr/local/bin/synnaxNext, give execution permissions to the binary:
chmod +x /usr/local/bin/synnaxYou’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 --insecureThis 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.
Using macOS
To start a single node cluster on macOS, first download the latest Synnax binary by running:
curl -LO github.com/synnaxlabs/synnax/releases/download/synnax-v0.38.1/synnax-v0.38.1-macosNext, move the binary to usr/local/bin:
sudo mv synnax-v0.38.1-macos /usr/local/bin/synnaxThen, give execution permissions to the binary:
chmod +x /usr/local/bin/synnaxYou’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 --insecureThis 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 adress 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.