Install the Delta Forge ODBC Driver on Linux from the deb or rpm package and register it with unixODBC.
delta-forge-odbc_<version>_amd64.deb | delta-forge-odbc-<version>.x86_64.rpm
## Overview The driver ships as a `.deb` (Debian, Ubuntu) and `.rpm` (RHEL, Rocky, Amazon Linux) for the `amd64` / `x86_64` architecture. The package depends on `unixODBC` and `libcurl`; both are present on every supported distribution out of the box. ## Prerequisites - glibc-based Linux, x86_64. - `unixODBC` installed. iODBC works for client libraries that link against it explicitly, but BI / ETL tooling on Linux overwhelmingly uses unixODBC. - A Secret Service implementation (GNOME Keyring, KWallet, KeePassXC) if you intend to store credentials in the OS keychain. The driver falls back to a mode-0600 file under `~/.config/deltaforge/credstore/` when no Secret Service is running. ## Steps 1. Download the `.deb` or `.rpm` from the Delta Forge release page (or the portable tarball). 2. Install with the platform package manager (see examples). The package writes a driver entry under `/etc/odbcinst.ini` and copies `libdeltaforgeodbc.so.<MAJOR>` into `/usr/lib/x86_64-linux-gnu/` (Debian) or `/usr/lib64/` (RHEL). 3. Verify with `odbcinst -q -d`. **DeltaForge ODBC Driver** should appear in the listing. 4. Add a DSN to `~/.odbc.ini` (user) or `/etc/odbc.ini` (system). The minimum is `Driver=DeltaForge ODBC Driver`, `Server=`, and `Uid=`. 5. Smoke-test with `isql -v <DSN-name>`. A successful connection prints `+---------------------------------------+` and a `SQL>` prompt. ## Tarball install (offline / locked-down hosts) If the host cannot use the package manager, extract the portable tarball and register the driver manually: ``` tar -xzf delta-forge-odbc-<version>-linux-x86_64.tar.gz sudo cp libdeltaforgeodbc.so* /usr/local/lib/ sudo ldconfig sudo odbcinst -i -d -f /dev/stdin <<'EOF' [DeltaForge ODBC Driver] Description=Delta Forge ODBC Driver Driver=/usr/local/lib/libdeltaforgeodbc.so UsageCount=1 EOF ``` ## Uninstall `sudo apt remove delta-forge-odbc` or `sudo dnf remove delta-forge-odbc`. The package managers remove the binary and the `odbcinst.ini` entry. User DSNs in `~/.odbc.ini` are left in place.
# Debian / Ubuntu
sudo apt install ./delta-forge-odbc_1.0.0_amd64.deb
# Red Hat / Rocky / Amazon Linux
sudo dnf install ./delta-forge-odbc-1.0.0.x86_64.rpm
# Verify driver registration
odbcinst -q -d -n 'DeltaForge ODBC Driver'
# Locate the registered shared object
odbcinst -j
# Add a user DSN with a heredoc
odbcinst -i -s -h -f /dev/stdin <<'EOF'
[DeltaForge]
Driver=DeltaForge ODBC Driver
Server=https://df.example.com
Uid=alice@example.com
EOF