Updates
ElyraSQL Client checks for new versions automatically and can download them for you — no package manager or manual hunting required.
How it works
- On launch, the app quietly asks elyracode.com whether a newer build exists for your platform. Nothing is shown unless there's an update.
- When an update is available, a green banner appears at the top: “ElyraSQL Client vX.Y.Z is available.”
- Click Update & restart. The app downloads the correct build for your
OS/architecture, verifies its SHA-256 checksum, installs it in place,
and relaunches on the new version — no manual steps:
- macOS — the app bundle in Applications is replaced automatically.
- Linux — the running binary is replaced in place.
- Choose Later to dismiss the banner for this session.
!!! note "Fallback" If the app can't write to its install location (e.g. it's running from a read-only mount), it falls back to downloading the file to your Downloads folder and opening it so you can install it manually.
You can trigger a check anytime from the command palette (⌘/Ctrl + K → “Check for updates…”).
What's sent
The update check requests a small public manifest and sends nothing about you or your databases. Downloads come over HTTPS from a first-party server and are checksum-verified before they're saved.
!!! note "Private distribution" Builds are published on elyracode.com rather than public GitHub releases, so updates always come from the official, first-party source.
Manifest (for maintainers)
The client reads https://elyracode.com/downloads/sql-client/manifest.json:
{
"version": "0.3.0",
"generated_at": "2026-07-10T20:26:24Z",
"files": [
{ "name": "ElyraSQL-Client-0.3.0-macos-arm64.dmg", "size": 4784126, "sha256": "…" },
{ "name": "elyrasql-client-0.3.0-linux-x86_64.tar.gz", "size": 4565474, "sha256": "…" },
{ "name": "elyrasql-client-0.3.0-linux-aarch64.tar.gz", "size": 4375584, "sha256": "…" }
]
}
The client compares version (semver) with its own, then picks the file whose
name matches the running platform. Artifacts are served from
…/downloads/sql-client/{name}. This manifest is produced and replicated by the
deploy_sqlclient workflow.