# Specifying the TLS Version

Use the `tls_version` global variable to specify the TLS versions allowed by the server. This variable can only be set at startup.

Versions below TLS1.2 are not supported from release 10.0.0 onwards. (i.e., 10.0.0+ only supports TLSv1.2 and TLSv1.3).

To see the current TLS version, run the following command.

```sql
SELECT @@tls_version;

```

```output

+-----------------------+
| @@tls_version         |
+-----------------------+
| TLSv1,TLSv1.1,TLSv1.2 |
+-----------------------+

```

## Configuring TLS 1.3

For engine version 10.0.0 and later, configure `tls_version` to include TLS 1.3. For example, the following command enables TLS 1.2 and TLS 1.3 on all nodes:

```
sdb-admin update-config --key tls_version --value "TLSv1.2,TLSv1.3" --all
```

The value takes effect after the nodes are restarted. Restart the nodes using the standard cluster restart procedure.

To verify the configured value, run:

```
SELECT @@tls_version;

***

TLSv1.2,TLSv1.3
```

The result should include TLSv1.3.

The client and server negotiate the highest TLS version supported by both sides. Ensure that the SQL client and its underlying TLS library support TLSv1.3 before enabling it.

## Toolbox

The following command updates the TLS version to TLSv1.2 or TLSv1.3 on all nodes in the cluster.

```shell
sdb-admin update-config --key tls_version --value TLSv1.2,TLSv1.3 --all

```

```output

Toolbox is about to run 'memsqlctl update-config --key tls_version --value TLSv1.2' on the following nodes:
    - On host 127.0.0.1:
      + 27235D3E385B1056478CE11258959592CE49EE82
      + F9F6A7E64946D5D3D1E6F00C175EF00FC240AB97

Would you like to continue? [y/N]: y
✓ Updated configuration on 127.0.0.1
Operation completed successfully
```

The following command restarts all nodes in the cluster for the new `tls_version` value to take effect.

```shell
sdb-admin stop-node --all

```

```output

✓ Successfully connected to host 127.0.0.1
Toolbox is about to perform the following actions:
  · Stop all nodes in the cluster

Would you like to continue? [y/N]: y
✓ Stopped Master node on 127.0.0.1 (1/1)
✓ Successfully stopped Master node on 1 host
✓ Stopped Master node
✓ Stopped Leaf nodes on 127.0.0.1 (1/1)
✓ Successfully stopped Leaf nodes on 1 host
✓ Stopped Leaf node
Operation completed successfully
```

```shell
sdb-admin start-node --all

```

```output

Toolbox is about to perform the following actions:
  · Start all nodes in the cluster

Would you like to continue? [y/N]: y
✓ Successfully connected to host 127.0.0.1
✓ Started Leaf nodes on 127.0.0.1 (1/1)
✓ Successfully started Leaf nodes on 1 host
✓ Successfully connected to Leaf node
✓ Started Master node on 127.0.0.1 (1/1)
✓ Successfully started Master node on 1 host
✓ Successfully connected to Master node
Operation completed successfully
```

```shell
singlestore -p

```

```output

Enter password:
Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 5
Server version: 5.5.58 MemSQL source distribution (compatible; MySQL Enterprise & MySQL Commercial)

Copyright (c) 2000, 2016, Oracle and/or its affiliates. All rights reserved.

Oracle is a registered trademark of Oracle Corporation and/or its
affiliates. Other names may be trademarks of their respective
owners.

No entry for terminal type "xterm-256color";
using dumb terminal settings.
Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
```

```sql
SELECT @@tls_version;

```

```output

+---------------+
| @@tls_version |
+---------------+
| TLSv1.2       |
+---------------+
1 row in set (0.01 sec)
```

The following command updates the `ssl_cipher` variable:

```shell
sdb-admin update-config --key ssl_cipher --value DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384 --all
```

***

Modified at: October 8, 2026

Source: [/db/v10/security/encryption/ssl-secure-connections/specifying-the-tls-version/](https://docs.singlestore.com/db/v10/security/encryption/ssl-secure-connections/specifying-the-tls-version/)

(An index of the documentation is available at /llms.txt)