Upgrade DIN

An upgrade is a new install over the old one: stop the field, run the new release's installer, and check the result. Your records, your token and your settings are kept.

Why stop the field first

From 1.0.30 the installer stops a field from the same install that is still running before it replaces the programs, then starts the new one (unless you pass --no-start). Installers before 1.0.30 did not: with those, the old field kept serving and din field start reported it was already up. Stopping it yourself first is harmless with any release, so the steps below keep it.

Steps

1. See what you run now:

din version

2. Stop the field. If you have din console running in a terminal, stop that too (Ctrl-C in its terminal).

din field stop

3. Download and verify the new release, unpack it, and run its installer with the same options you used the first time (for example the same --prefix or --port):

tar xzf din-<version>-linux-x86_64.tar.gz && cd din-<version>
sh install.sh

The installer starts the field again when it finishes. If you install with --no-start, start it yourself:

din field start

4. Check it:

din version
din status

What is kept

~/din/records: your records. The installer never deletes or rewrites them.
~/din/.din/field.token: an existing token is never overwritten, so your field opens with the same token.
~/din/.din/field.env: an existing settings file is left alone. To pick up a new default, delete it and install again.
~/.din/plugin.env: the plugin's settings, left alone if present.
~/din/.din/license.key and the entitlement files din activate wrote: the installer does not touch them.
The login entry din autostart on made, if you turned it on. It runs ~/din/bin/din, so from the next login it runs the new release.
~/din/.din/hosted.env, if you ran din hosted connect.

What is replaced

The eight programs in ~/din/bin, and the din-recall link.
The plugin payload in ~/din/plugin. The plugin's installer runs again for the agent you pick (Claude Code, Cursor or OpenCode; see Install).

Windows

The same order applies: din field stop, then the new release's install.ps1, then din status. Windows installs of this release are unverified.

Changelog: what changed in each release.
Uninstall