Deployment Quick Start
Start a Core for testing, learning, or development.
This page will walk you through starting a Synnax Core. To get started, select your operating system below:
Using Docker
The simplest way to start a Core is by using the synnaxlabs/synnax Docker image:
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 Core with the following parameters:
| Flag | Description |
|---|---|
-p 9090:9090 | Maps port 9090 on the host to port 9090 in the container |
--listen=localhost:9090 | Sets the address that the Core will listen on |
--mem | Store all data in memory (useful for learning and development) |
--insecure | Run without TLS |
If you’re interested in more details on these flags, see the CLI Reference.
To stop the Core, simply press Ctrl+C in the terminal.
Using Windows
Releases for other operating systems and older versions can be found on the releases page.
To start the Core, run this command in a PowerShell terminal:
synnax start --listen=localhost:9090 --mem --insecureThis will start a Core with the following parameters:
| Flag | Description |
|---|---|
--listen=localhost:9090 | Sets the address that the Core will listen on |
--mem | Store all data in memory (useful for learning and development) |
--insecure | Run without TLS |
The Core CLI Reference contains more details about these flags.
To stop the Core, simply press Ctrl+C in the terminal.
Using Linux
To start a Core on Linux, first download the latest Synnax binary by running:
curl -LO github.com/synnaxlabs/synnax/releases/download/synnax-v0.51.1/synnax-v0.51.1-linuxThen, move the binary to /usr/local/bin:
sudo mv synnax-v0.51.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 Core:
synnax start --listen=localhost:9090 --mem --insecureThis will start a Core with the following parameters:
| Flag | Description |
|---|---|
--listen=localhost:9090 | Sets the address that the Core will listen on |
--mem | Store all data in memory (useful for learning and development) |
--insecure | Run without TLS |
If you’re interested in more details on these flags, see the CLI Reference.
To stop the Core, simply press Ctrl+C in the terminal.
Using macOS
To start a Core on macOS, first download the latest Synnax binary by running:
curl -LO github.com/synnaxlabs/synnax/releases/download/synnax-v0.51.1/synnax-v0.51.1-macosNext, move the binary to usr/local/bin:
sudo mv synnax-v0.51.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 Core:
synnax start --listen=localhost:9090 --mem --insecureThis will start a Core with the following parameters:
| Flag | Description |
|---|---|
--listen=localhost:9090 | Sets the address that the Core will listen on |
--mem | Store all data in memory (useful for learning and development) |
--insecure | Run without TLS |
If you’re interested in more details on these flags, see the CLI Reference.
To stop the Core, simply press Ctrl+C in the terminal.