Outdated Version

You are viewing an older version of this section. View current production version.

/Deploy/ /

Run the Container min read

The SingleStore DB cluster-in-a-box image contains two nodes: A master aggregator node that runs SQL queries and aggregates the results, and a single leaf node, which is responsible for storing and processing data. These two nodes form the most basic cluster.

Start the Container

Export your license key into an environment variable named LICENSE_KEY. If your license key is not shown in the code block below, you can copy it from the SingleStore Customer Portal.

Linux/macOS
```
export LICENSE_KEY=[YOUR_LICENSE_KEY]
```
```
export ROOT_PASSWORD=[YOUR_ROOT_PASSWORD]
```
Windows
```
set $LICENSE_KEY=YOUR_LICENSE_KEY
```
```
set $ROOT_PASSWORD=YOUR_ROOT_PASSWORD
```
```
set $START_AFTER_INIT=Y
```

Initialize the cluster using docker run. Note: If you want to preserve data across an upgrade of the Docker container, add a -v singlestore-ciab-data:/var/lib/memsql before singlestore/cluster-in-a-box in the command below.

Linux/macOS

docker run -i --init \
    --name singlestore-ciab \
    -e LICENSE_KEY=$LICENSE_KEY \
    -e ROOT_PASSWORD=$ROOT_PASSWORD \
    -p 3306:3306 -p 8080:8080 \
    singlestore/cluster-in-a-box

Windows

docker run -i --init `
    --name singlestore-ciab `
    -e LICENSE_KEY=%$LICENSE_KEY% `
    -e ROOT_PASSWORD=%$ROOT_PASSWORD% `
    -e START_AFTER_INIT=%$START_AFTER_INIT% `
    -p 3306:3306 -p 8080:8080 `
    singlestore/cluster-in-a-box

If initialization fails, you will need to remove the container before retrying.

docker rm singlestore-ciab

Start the container.
```
docker start singlestore-ciab
```

Now that you have SingleStore DB up and running, learn how to connect to your cluster in the next step.

Was this Article Helpful?

Need help or have suggestions? Go to SingleStore Forums Next Step

Run the Container min read

Start the Container

Sorry About That