Skip to the content

Release Notes

IIZI 5.1 Release Notes

Upgrading from 5.0

What to check before and after you update from IIZI 5.0 to 5.1.

November 20, 2026 · applies from IIZI 5.1.0

5.1 is an update within IIZI 5: applications, servers and iiziRun stay on the 5.x line, and most installations update without a change. The steps below are the exceptions, in the order you meet them.

Before the update: the server

The database settings of the configuration file

The database directory, host, port, auto-create and auto-start of the server's configuration file are used from 5.1 on, whenever the command line does not give them; 5.0 ignored them. Check them before the update: a server whose file names another database than the one it runs on will use the file's. The launchers of the installation give the database directory and port on their command line, as before, and the command line still wins.

One name per settings entry

Port configurations, server environments, mail senders and Let's Encrypt domains share one name space. If two of them share a name – a port configuration and an environment both called main, say – rename one before the update: a configuration file with such a pair is refused at load, and the server ends with exit code 9.

Exit code 9

A server that fails to start on its configuration ends with exit code 9 instead of 0, and so does a server started with an invalid -app ID (one that holds a character other than A-Z, a-z, 0-9, dot and underscore, or does not begin with a letter). A supervisor that restarts on any non-zero code should treat 9 as “fix the configuration”.

Log readers

A reverse proxy's access log

A reverse proxy that logs full request addresses writes each reconnection's session ID and secret token (reconnect and rt in the address) into its access log. Leave the query string out of that log, or keep the log confidential.

Mail

Every mail sender now gives up after 10 seconds for the connection and 15 seconds for a reply or a write. A mail host that needs more than 15 seconds for one reply needs the sender's timeout set. Mail to the reserved test domains is refused when it is queued, unless the relay runs on the server's own computer.

After the update: the server

A Windows service and the secrets store

To give a Windows service its own secrets store in %ProgramData%\iizi\secrets, install the service again with the new is.bat: an update keeps the service programs it finds in bin\ntservice. The values of an existing secrets store are not moved; set them again with the secrets tool, which uses the service's store by default.

Style sheets and Node.js

To minify style sheets with lightningcss, set the environment variable NODE_HOME of the server to a Node.js installation and install lightningcss globally for that Node. Without them, a built-in minifier does the work and the server writes one WARNING that says which requirement is missing.

The Server Monitor

iiziGo's Server Monitor reaches a development server from the same computer only: name the server localhost in the view. For a development server on another computer, start it with -Diizi.allow.monitor.remote=true, on a trusted network only.

The VirtualSpace Viewer

A production server no longer serves the VirtualSpace Viewer. On a development server it shows no administrator's session unless the server's Java is started with -Diizi.allow.vsviewer.admin=true.

Accounts and sign-in

Applications

Buttons

A button's text no longer wraps by default. Where a label should wrap over several lines, set the button's Text wrap to “Multiple lines” in iiziGo, or call setTextWrap; “Ellipsis” cuts a long label and shows the full text as a tooltip.

Grid layout and dialogs

The Grid layout keeps every component inside its container: a grabbing column without a Minimum width can now shrink to 0, so give such a column a Minimum width where its content must stay visible. A dialog larger than the window is limited to 90 % of it and scrolls inside. Look at panels with grabbing columns and large dialogs once after the update.

Module names

A Module project whose name holds #, % or $ could not be served and is now refused by the server; iiziGo marks such a project with a warning. Rename it.

Java code

Removed components and their replacements

RemovedWhat to use instead
Dojo's rich text editor (dijit/Editor, dijit/_editor, dojox/editor)Your own copy of the editor in the application's JavaScript; iiziGo's text editor of the Text Table editor is unchanged.
The Calendar list and Calendar event components, dojox/calendarNever in a released palette. Remove such a component from a panel; the message at load names the panel and how to repair it.
Currency support (dojo/currency, CurrencyTextBox) and the non-Gregorian CLDR calendarsYour own copy in the application's JavaScript.
dojox/dnd, dojox/gfx3d and the 3D charts, the dojox ColorPickerYour own copy; UIChart draws two-dimensional charts.
The claro theme files, dijit/icons, dijit-all.jsThe IIZI, Graphite and Contrast themes; claro was no longer a choice in 5.0.
SystemConfig.isWinNextNothing: it was always false.

iiziGo

Back to the IIZI 5.1 release notes