¶Troubleshooting

¶Connection

??? question "“Timed out connecting”" The server isn't reachable at the host/port. Check the server is running, the address is correct, and no firewall blocks the port (ElyraSQL defaults to 3307).

??? question "“Authentication failed”" Wrong username/password. Re-enter them in the connection dialog (Test to verify). Passwords are stored in the keychain per connection.

??? question "“TLS error”" The server didn't offer a certificate the client accepts. If the server has no TLS, turn Require TLS off; otherwise check the server's certificate.

??? question "Remote connection is blocked" Remote (non-loopback) connections require Pro or Premium. See Editions.

¶Editing & features

??? question "A feature is greyed out or shows 🔒" It requires a higher tier. The palette shows the required tier; activate a license from the edition badge. See Editions.

??? question "“Editing … requires Pro” / “read-only”" Free is read-only, and read-only connections refuse writes. Upgrade, or use a writable connection.

??? question "Can't edit or delete rows in a table" Inline editing needs a single-column primary key to target rows safely.

¶Licensing

??? question "Activation says it can't reach the store" Check your network. A previously validated license keeps working offline for 14 days.

??? question "My license stopped working" It may have expired or been revoked, or you've been offline past the grace period. Reconnect and re-open Account & license, or check elyracode.com.

¶macOS

??? question "“App can't be opened”" The official DMG is signed and notarized. Re-download from elyracode.com; avoid unofficial copies.

¶Linux

??? question "Missing library on launch" Install WebKitGTK/GTK: sudo apt-get install libwebkit2gtk-4.1-0 libgtk-3-0.