Skip to content

Add the 0.16.2 installation guide - #57

Merged
cevheri merged 1 commit into
libredb:mainfrom
yusuf-gundogdu:add-0.16.2-guide
Sep 21, 2026
Merged

cevheri merged 1 commit into
libredb:mainfrom
yusuf-gundogdu:add-0.16.2-guide

Conversation

@yusuf-gundogdu

Copy link
Copy Markdown
Member

The 0.16.1 guide stays exactly where it is, at /helper/0.16.1.html. Someone who installed that release is still reading it, so a published guide is never edited. A new release opens as a copy of the last one and is corrected against the running build.

/helper/ now lists both and points at 0.16.2 as the current one.

What 0.16.2 changed, and what the guide now says

The preview statement lost its limit. Clicking a table in the tree used to put SELECT * FROM schema.table LIMIT 50 in the editor. It now puts SELECT * FROM schema.table and sends the fifty rows as a run option, so the text a reader copies out of that editor reads every row when they run it somewhere else. The guide says so.

Result paging moved into the status bar. Load More under the grid is gone. The button sits beside the row count and names the page it will fetch: a tree preview offers load 50 more, a statement you ran yourself offers load 500 more. Five engines never show it at all, because a second page from any of them either errors or hands back the first: LibreDB, MongoDB, Redis, Cassandra and Elasticsearch. OpenSearch, on the same implementation, does page.

Elasticsearch takes an API key pair in the connection form. OpenSearch does not, and the guide says which is which.

Two install channels went live, and both have a panel now. YunoHost is the one catalogue here that installs no container: it unpacks the standalone tarball under systemd behind your own nginx. The okxlin community store for 1Panel mounts a data volume and sets STORAGE_SQLITE_PATH, but never sets STORAGE_PROVIDER. I ran the template to check: the container answers {"provider":"local","serverMode":false}, so saved connections stay in the browser, the configured path is never written, and the volume ends up holding the two sample databases plus auth-bootstrap.json, which carries the generated administrator password and the signing secret in clear text. The panel says to add STORAGE_PROVIDER=sqlite and to treat that directory as a password file.

Screenshots

All forty were taken again from a 0.16.2 container with a PostgreSQL database of 620 orders and a MySQL database of 900 transactions behind it. Nothing was carried over, and the two agent runs among them were produced by actually running them. Every figure was checked against the sentence beside it; where they disagreed, the sentence was wrong and was corrected.

Accessibility

The forty alt texts now carry every language rather than English alone, swapped by the same control that switches the prose. Traditional Chinese gets the typography rules the other twelve already had: [lang="zh"] is an exact attribute match in CSS, so zh-Hant was picking up a Latin font stack and the wrong line-breaking.

Checks

bun run gate clean (typecheck, prettier, oxlint, knip, build, 219 tests), bun run secrets clean, bun run a11y clean with all 22 routes at 95 or better. Branch is level with main.

The 0.16.1 guide stays where it is. Someone who installed that release is
still reading it, so a published guide is never edited; a new release opens
as a copy and is corrected against the running build.

What this release changed, and the guide now says:

- Clicking a table in the tree no longer writes a limit into the statement.
  The editor gets SELECT * FROM schema.table and the fifty rows come back as
  a run option, so the text you copy out reads every row somewhere else.
- Result paging moved into the status bar. Load More under the grid is gone;
  the button sits beside the row count and names the page it will fetch, so a
  tree preview offers fifty and a statement you ran offers five hundred.
  Five engines never show it: LibreDB, MongoDB, Redis, Cassandra and
  Elasticsearch. OpenSearch, on the same implementation, pages.
- Elasticsearch takes an API key pair in the connection form. OpenSearch
  does not.
- YunoHost and the okxlin community store for 1Panel are live, and both have
  an install panel now. The 1Panel template mounts a data volume and sets the
  SQLite path but never sets STORAGE_PROVIDER, so saved connections stay in
  the browser and the volume holds the samples plus auth-bootstrap.json, which
  carries the generated password and the signing secret in clear text.

All forty screenshots were taken again from a 0.16.2 container with a
PostgreSQL database of 620 orders and a MySQL database of 900 transactions
behind it, the two agent runs among them by running them. Their alt text is
now carried in all thirteen languages rather than English alone, and
Traditional Chinese finally gets the typography rules the other twelve have.
@cevheri
cevheri merged commit 5118015 into libredb:main Sep 21, 2026
2 checks passed
@yusuf-gundogdu yusuf-gundogdu mentioned this pull request Sep 21, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants