DOCS / MEJA

Troubleshooting

Work through connection, query and import problems one step at a time.

Connection test fails

Check the selected engine, host and port. A URL for a web admin page is not the database server address.
Confirm the user, password and database name. Check whether that user has permission to connect.
For SSH, test the SSH connection separately and verify that the database is reachable from the SSH host.

TLS or certificate errors

Check the selected TLS mode, CA certificate and hostname. With hostname verification enabled, the server certificate must match the host you entered. Ask the server administrator for the correct CA or connection address.

Import fails or maps the wrong columns

Recheck the file format, delimiter, header setting and column mapping. Headerless CSV files need the intended table-column order or an explicit mapping. For SQL dumps, use the reported statement index to locate the failing statement.

Report a reproducible issue

Open a GitHub issue with your Meja version, operating system, database engine, steps to reproduce and a redacted error message. Remove credentials, private hostnames and sensitive rows before sharing screenshots or queries.