MySQL SSH

MySQL is an open source relational database that powers many applications and is one of the most popular databases in the world. By using MySQL as a data destination on the Kondado platform, you can create your Data Warehouse using both MySQL and MariaDB.

SSH pipeline differs from traditional pipeline in that it connects to the database through an intermediate server, also called a tunnel or bastion.

Before adding the database, make sure that the intermediate server is accessible to our IPs that are listed here and that the intermediary server can access the database on the port that will be used (generally 3306), then follow the steps below:

1) Login to the Kondado platform

2) Navigate to add destinations page click “New Destination” and select the MySQL SSH destination

3) Fill in your database information as shown below:

Name: This is the internal description of your destination on the Kondado platform

Server Address: The address of the intermediary server that will access your database

Server port: The passthru server port that will access your database

Server user: The passthru server user who will access database

Server PEM Key: The text of the file with the PEM key for passthru server access

Database address: The server address of your database

Database port: The port of your database (usually 3306)

Database User: The username Kondado will use to enter data into your database. This user must have DROP, INSERT, CREATE, ALTER, SELECT, DELETE, and PROCESS permissions

Database Password: The database user's password

Database: the name of the database (dbname)

Click save and your new destination will be created!

ATTENTION

a) The sql_require_primary_key parameter must be disabled – it is common for clouds like Digital Ocean to leave it enabled

b) Settings such as STRICT_TRANS_TABLES that require values in all columns (default value constraint) must be disabled

Create a MySQL SSH Destination on Kondado

Set up a MySQL or MariaDB destination on Kondado using an SSH tunnel (bastion server) for secure database connectivity.

1
Prepare your SSH tunnel server

Ensure your intermediate bastion server is accessible to Kondado's IPs and can reach your database on port 3306. Review security requirements for IP allowlisting before proceeding.

2
Configure database permissions and settings

Create a database user with DROP, INSERT, CREATE, ALTER, SELECT, DELETE, and PROCESS permissions. Disable sql_require_primary_key and STRICT_TRANS_TABLES settings, as these are commonly enabled by default on cloud providers like Digital Ocean.

3
Add the MySQL SSH destination on Kondado

Log in to the Kondado platform, navigate to the destinations page, click "New Destination," and select MySQL SSH.

4
Enter SSH tunnel server details

Fill in the Server Address, Server port, Server user, and paste the Server PEM Key text for your bastion server that will tunnel connections to your database.

5
Enter database connection details

Provide the Database address, Database port (usually 3306), Database User, Database Password, and Database name (dbname). Click save to create your destination.

Frequently asked questions

What is the difference between a MySQL SSH destination and a regular MySQL destination?
A MySQL SSH destination connects to your database through an intermediate server (tunnel or bastion), while a traditional pipeline connects directly. The SSH tunnel adds a security layer by routing traffic through a controlled access point.
Which database permissions does Kondado need for the MySQL SSH destination?
The database user must have DROP, INSERT, CREATE, ALTER, SELECT, DELETE, and PROCESS permissions. These allow Kondado to fully manage tables and load data into your data warehouse destination.
Why do I need to disable sql_require_primary_key and STRICT_TRANS_TABLES?
These settings interfere with Kondado's data loading process. sql_require_primary_key prevents table creation without primary keys, and STRICT_TRANS_TABLES enforces default values in all columns—both common defaults on cloud providers like Digital Ocean that must be turned off.
What port should I use for the database connection?
The standard MySQL port is 3306, which you should use for the Database port field. The Server port for your SSH bastion depends on your server configuration, commonly 22 for SSH.
Can I use MariaDB instead of MySQL with this destination?
Yes, the MySQL SSH destination supports both MySQL and MariaDB. Kondado treats them interchangeably for data integration purposes when creating your data warehouse.

Written by·Published 2023-09-23·Updated 2026-04-25