SingleStore DB

Start the Container
  1. 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
  2. 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
    
  3. 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.