Skip to content

0.4.1 - db-sync over SSH survives restarts

Latest

Choose a tag to compare

@GNP1-dev GNP1-dev released this 29 Sep 15:33

⚠️ Beta software, no warranty. PoolTerminal is early software and has mainly been exercised on one operator's setup. It is read-only by design and holds no key material, but it does hold SSH access to your block producer, and that limit is not a guarantee. It has had an AI-assisted code review, not an independent security audit. Provided as-is under Apache 2.0 with no warranty of any kind - you use it at your own risk. See SECURITY.md.

[0.4.1] - 2026-09-29

A bug-fix release for db-sync on another machine and for disk use. Same
requirements as 0.4.0: cardano-node 11.1.2 or later with cardano-cli 11.2.3.0
or later, and (optional) cncli 6.8.0 or later.

Fixed

  • db-sync on another machine (over SSH) now works after a restart. The
    connection test passed, but after restarting PoolTerminal quietly used
    Koios instead. The setup wizard now keeps your saved db-sync settings when
    you open it again, asks for the database password at startup if it is not
    remembered (and for the SSH key passphrase, which is never stored), and the
    "Remember" option sits right under the password field.
  • db-sync failures are shown, with the real reason. If db-sync is set up
    but cannot connect - for example a wrong password, a missing key file or an
    SSH problem - Delegators, the Data tab and History now say so and why, with
    a Retry button, instead of silently falling back to Koios.
  • "~" in SSH key paths now works (for example ~/.ssh/id_ed25519), and
    key files are checked when you enter them: a missing or unreadable file,
    or a key that needs a passphrase, is reported with its path.

Improved

  • SSH connections use keepalives, so a dropped link is noticed instead of
    hanging, and a dropped db-sync tunnel reconnects once by itself.
  • Much less disk writing. A few values were rewritten many times a
    minute, which grew a local storage file to around 1 GB on some installs.
    They are now smaller and saved at most every minute or so. The large file
    is cleared the next time PoolTerminal starts.
  • Setup help recommends a read-only database role with a password, with
    the commands to create one; "no password (loopback trust)" is marked as not
    recommended. The SSH port for the db-sync machine is no longer assumed to be
    22.

Note

  • "Remember" stores the db-sync password unencrypted on this computer, so
    use a read-only database role. Storing it in the system keyring is planned
    for 0.5.0.