Troubleshooting

Here are some common issues that you might encounter and how to fix.

Connection window is hidden

Issue: A new window is opened and you can see it in the Mission Control, but it doesn't show up.

What to do: Open Terminal and run the command below to remove the config file (No data loss so don't worry):

rm ~/Library/Preferences/com.tinyapp.TablePlus.plist

Can't connect over SSH

Issue: The connection setup is correct but you can't connect via SSH Tunnelling.

What to do: This is a very unexpected issue. If you encounter this, enable the SSH debug log (navigate to menu Help > Enable SSH Debug Log) then send the log to [email protected]. It will help us troubleshoot faster.

The package is damaged

Issue: You install the app on macOS and see the error message: "The package is damaged".

What to do: It's probably your macOs version is not supported. TablePlus supports macOS 10.11 and newer. Update your macOS then.

Error displaying table data

Issue: When opening a table data, some characters can't be shown correctly.

What to do: Change to use a proper Encoding, navigate to menu Connection > View Using Encoding > Then choose the encoding suitable for the table.

Query results section is hidden

Issue: The table of query results is hidden. Even after you execute the query, you still can't find it.

What to do: Drag the bottom border of the query editor up.

Can't import CSV

Issue: When importing data from a CSV file, there are some errors that make it unable to finish.

What to do: There are generally two reasons for that:

  • The wrong encoding was used. Then change encoding and try again.

  • Mismatch datatype. It's important to do some basic data checking before importing and make sure the datatypes are matched correctly

To make it easier, when you import, you can match all fields as text fields and that works for 99% of the time. ou can have the option to create a table with all text columns.

Invalid License

Issue: You have a valid license key but when trying to activate, it says The license key is invalid.

What to do: Many users got this error because of pasting multiple times. Make sure you copy the exact licence key, and paste it one time in the field to activate it.