Updates
FreeThe editor looks for new versions by itself and shows them to you. It never installs on its own: installing restarts the editor, and that ends programs running in its terminals. You decide when to install.
What you do here
- Learn that a new version is out, and check by hand: Check and notify.
- Install an update and know what happens to terminals and Claude sessions: Install.
- Agree to changed terms when an update offers it: Consent to terms.
- Read what is new in which version: Changelog.
Layout
- Window: a new version announces itself with the dialog "Version … is available" and its release notes.
- Status bar: Update with the version number while an update is waiting. A click opens the changelog.
- Title bar: a dot on the button on the right (WebDonkey or Without WebDonkey), and "View editor update …" in the menu behind it.
- Changelog tab: version, manual check, the waiting update and all release notes.
The editor checks shortly after start and then every 10 minutes while it runs. With several windows open, they keep each other up to date so none offers an outdated version. The switches are under Settings › Features in the App group (Features).
Free and Premium
Updates are free for everyone.
Check and notify Free
The editor asks regularly whether a new version is out and tells you in several places. This page covers where you see an update, what the buttons in the dialog do and how to check by hand.
Where to find it
- Automatically: shortly after start and then every 10 minutes.
- By hand: menu WebDonkey Editor › Check for Updates…, command palette Check for Updates…, Check for updates in the menu on the right of the title bar, or the Check for updates button in the Changelog tab.
How you learn about an update
- Dialog: "Version … is available" with the old and the new version number and the release notes. It only appears in the main window and waits until you pause typing and no other dialog is open.
- Status bar: Update with the version number. A click opens the Changelog.
- Title bar: a dot on the button on the right. The menu says "View editor update …".
The dialog
| Button | What it does |
|---|---|
| Install now | installs the update, see Install |
| Later (also Esc or a click outside) | The dialog does not come back for this version, not even after a restart. The next newer version is announced again. |
| Open changelog | like Later, and opens the Changelog tab |
| Skip this version | hides the offer in the status bar and title bar until a newer version comes. Opening the changelog or checking by hand still shows the version. |
| Don't announce new versions in a window | switches the dialog off entirely. Updates still show in the changelog and the status bar. |
Below the release notes it says: "Installing restarts the editor. If anything is unsaved, it asks you first." If terminals or Claude sessions are running, the dialog states how many.
Checking by hand
When you check by hand, the editor opens the Changelog tab and shows the result at the top: "You're up to date.", "Version … is available" or "Could not check for updates." A manual check offers a skipped version anyway.
Settings
Under Settings › Features, group App:
| Setting | What it does | Default |
|---|---|---|
| Check for updates automatically | Once at start, then every 10 minutes. Installing always waits for your click. | on |
| Announce new versions in a window | Closing the window skips only that version; the next one is announced again. Off: updates still show in the changelog and the status bar. | on |
What happens in the background
The editor asks the editor's update channel in the WebDonkey shop, sending the installed version, the platform and the processor architecture. If it cannot reach the shop, the automatic check stays quiet and tries again after a minute, then at growing intervals. With several project windows open, only the main window checks on schedule. The others take its result and can install the update just as well.
Troubleshooting
| What you see | What to do |
|---|---|
| "Could not check for updates." | Check the connection and click Check for updates in the changelog again |
| No dialog although an update is there | Check Announce new versions in a window. If you dismissed the dialog for this version, the update only shows in the status bar and changelog. |
| No update in the status bar | Check Check for updates automatically and the status bar switch Update notice under Features. |
See also
Install Free
You always install an update yourself, with a click. The editor downloads the new version, checks its signature, installs it and restarts. It resumes Claude sessions after the restart; other programs in terminals end with it.
Where to find it
- In the dialog "Version … is available": Install now
- In the Changelog tab, on the update's card: Install and restart
How to do it
- Click Install now or Install and restart.
- If the update announces changed terms and a license key is entered, the editor asks about that first, see Consent to terms. You get the update either way.
- If anything is unsaved, the editor asks what should happen to those files.
- The button shows Installing… with the progress in percent.
- If you kept typing during the download, the editor asks once more about those files before restarting.
- The editor restarts in the new version.
What happens to running programs
Before installing, the editor lists below the release notes what is running:
- Running terminals with their number: the restart ends them. Stop what you want to keep first, a dev server for example.
- Claude sessions with their number: they are resumed after the update.
The editor writes Claude sessions down before the restart and picks them up afterwards, in the same project and terminal, including Mission Control's background sessions (Mission Control). If a reply was in progress, Claude gets a "continue" afterwards.
Requires WebDonkey
Some release notes start with "Requires WebDonkey" and a version number. That is the WebDonkey version this editor version expects at least. If WebDonkey on your Mac is older, the editor runs without WebDonkey after the update at first: editor, files, terminal and git work, and Settings › About asks you to update WebDonkey. As soon as WebDonkey is updated, the editor connects again by itself. Without WebDonkey on your Mac the note does not matter.
What happens in the background
Right before installing, the editor asks the update channel once more and takes what it offers now. A window that still knows an older version does not install the old one by accident this way. If the channel does not answer within a few seconds, the editor installs the known version. It checks the downloaded version against its signature before putting it in place.
Troubleshooting
| What you see | What to do |
|---|---|
| "Update failed:" with a message | Check the connection and install again. Until then the old version stays installed. |
| After the update Remote, database and themes are missing | WebDonkey is older than the editor needs. Update WebDonkey, see above. |
| You cancelled the question about unsaved files | The editor does not install. Save and click again. |
See also
Consent to terms Free
When WebDonkey's terms change, the editor asks during an update install whether you agree to the new terms. You get the update either way, with or without consent. The question only comes when a license key is entered and you have not agreed to the announced version yet.
Where to find it
The question appears after you click Install now or Install and restart, never while checking for updates.
How to do it
- Click Install now.
- The dialog "Our terms change on …" names the date and shows what changes.
- Read the new terms opens the new version in the browser.
- Choose:
- Agree and update: the editor sends your consent and then installs.
- Only update: the editor installs without agreeing. It asks again on the next update while the change is still open.
- Cancel: nothing is installed.
No button is preselected, so Enter does not pick one.
What else the dialog says
Below the link it says what happens without consent: your subscription ends on a given date, with several subscriptions each on its own date. Until then the current version applies. At the end it says: "You get the update either way."
Company accounts
If the license belongs to a company account or you share it with a team, the company agrees in the customer account. The dialog then says "Your company agrees to the new terms in the customer account" and offers Open customer account and Continue updating.
What happens in the background
Whether the terms change is part of the update channel's answer. Only when you click install does the editor ask the shop, with your license key, whether you have agreed already. On your Mac it only stores which version you agreed to and when. It never stores a "no". If the shop does not answer, the editor goes on installing without asking.
Troubleshooting
| What you see | What to do |
|---|---|
| "Consent not sent, you can agree in your customer account" | The update continues anyway. Agree in the customer account with Open customer account. |
| No question although the terms change | Without a license key the editor does not ask. With WebDonkey the key in WebDonkey counts, without WebDonkey the one in the editor. If you have agreed already, in the customer account for example, it does not ask either. |
See also
Changelog Free
The Changelog shows the installed version, a waiting update with its release notes, and every version of the editor with date and release notes. It opens as a tab in the editor area.
Where to find it
- Menu Help › Changelog & Updates
- The button on the right of the title bar (WebDonkey or Without WebDonkey), then Changelog
- Settings › About, row WebDonkey Editor: Changelog & Updates
- Command palette: Changelog & Updates
- Status bar: click Update while an update is waiting
Layout
- Header: WebDonkey Editor with the installed version, on the right the state ("Checking…", "You're up to date." or "Could not check for updates.") and the Check for updates button.
- Update card, when one is waiting: "Version … is available", the release notes, what is running, plus Install and restart and Skip this version.
- Changelog: every version with date and release notes, newest first. The installed one is labelled installed. Show more loads older versions.
Links in the release notes open in the browser. The notes come in your language, German with a German interface, otherwise English. Some start with "Requires WebDonkey" and a version number, see Install.
What happens in the background
On opening, the changelog asks the update channel afresh so the card at the top matches the list. This counts as a manual check: it also shows a version you skipped, but installs nothing. The editor loads the list of versions from the WebDonkey shop, sending only the requested language.
Troubleshooting
| What you see | What to do |
|---|---|
| "The changelog could not be loaded." | Check the connection and open the tab again |
| "No releases yet." | The shop has no versions for the editor yet. |
WebDonkey has a changelog of its own. The editor announces a WebDonkey update separately in the menu on the right of the title bar ("WebDonkey update …: open WebDonkey").