Managing Connections

Creating a Connection

1. Navigate to the Connections page from the sidebar
2. Click "+ New Connection"
3. Select the connection type (MySQL, PostgreSQL, SFTP, etc.)
4. Fill in the required credentials (host, port, username, password, etc.)
5. Click "Test Connection" to verify the credentials work
6. Click "Save" to create the connection

TIP

Always test your connection before saving. This catches issues like incorrect passwords, firewall rules, or unreachable hosts.

Editing a Connection

1. Go to the Connections page
2. Click on the connection you want to edit
3. Update the fields as needed
4. Sensitive fields (passwords, API keys) will appear masked — enter a new value to change them
5. Test and save

WARNING

Editing a connection affects all workflows that use it. Make sure active workflows won't be disrupted.

Testing a Connection

You can test a connection at any time:

1. Open the connection details
2. Click "Test Connection"
3. The result shows either a success status or an error message describing what went wrong

Common test failures:

• Connection refused — host is unreachable or port is blocked
• Authentication failed — incorrect username or password
• Timeout — network issue or host is too slow to respond

Deleting a Connection

1. Open the connection details
2. Click "Delete"
3. Confirm the deletion

DANGER

Deleting a connection will break any workflows that use it. Those nodes will fail with a "connection not found" error at execution time.

Connection Status

Each connection displays its last test result:

• OK — the last test was successful, with a timestamp
• Error — the last test failed
• Not tested — the connection hasn't been tested yet