Buy

Window and navigation

Free

The WebDonkey window has three fixed parts: the sidebar on the left, the top bar above the content and the content of the page that is open. Sidebar and top bar are the same on every page. From there you start and stop services, switch pages, open the search and see what has finished in the background.

What you do here

Layout

Part Content
Sidebar head logo, app name, version with Changelog, bell
Sidebar pages in the groups Local, Remote, Monitoring, Tools, Account & Help
Sidebar footer Settings, Search & commands (⌘K), Report a problem, theme switcher, Collapse sidebar
Top bar Start all, Stop all, Restart, New site, transfers, Free or Premium, service status
Content the page that is open, with warning banners above it when needed

Without an internet connection the window keeps working. Only what needs the network (update check, changelog, license check) waits until the connection is back.

Quitting WebDonkey

You quit WebDonkey with ⌘Q. The app stops its services on the way out. If operations are still running on a server (a restore, a sync or a backup, for example), WebDonkey first asks Quit WebDonkey? and says how many are still running. Quit quits anyway, Cancel keeps the app running.

Free and Premium

The window itself is the same on Free and Premium. On Free the sidebar also has a Premium entry, and the top bar shows Free. Which pages belong to Premium or an add-on package is listed with the sidebar.

Top bar Free

The rounded bar above the content is there on every page. On the left you control all services at once and create a site, on the right you see running transfers, your license status and how many services are running. The bar is also the window's handle: grab it at a free spot to move the window.

Left: controls

Button What it does
Start all Starts all services and the front proxy.
Stop all Stops all services and the front proxy.
Restart Stops all services, starts them again and restarts the front proxy.
New site Opens the Sites page with the New site form, see Your first site.

While an action runs, the button reads Starting…, Stopping… or Restarting….

A service is a program that runs in the background and serves your sites, such as PHP-FPM, nginx, MySQL or Mailpit. The front proxy takes every request on ports 80 and 443 and hands it to the right site.

Right: state

Transfers

The icon with the two arrows only appears while downloads or uploads from the file manager of an SFTP connection are running, or when a transfer has failed. It shows the progress in percent or the number of failed transfers. A click opens the Transfers list with progress, amount and time left for each transfer. Clear finished tidies up the list, the cross on a row cancels that transfer. Transfers keep running when you switch pages. Quitting WebDonkey cancels running transfers.

Free or Premium

The badge shows Free or Premium. Its tooltip names the exact license state, such as Premium active or Premium (offline). A click opens the settings, where you manage the license.

Service status

On the far right the bar shows how many services are running, with a coloured dot:

Shown Meaning
"5/8 services running" with a green, pulsing dot This many services (the front proxy included) are running.
All services stopped with a grey dot Nothing is running.
A service has crashed with a red dot At least one service has crashed.

A click opens Active services: everything that runs right now, meaning services, site processes and the front proxy. Every row has Restart and Stop. If nothing is active, it says Nothing is running right now. At the bottom, Manage services leads to the Services page. Esc or a click outside closes the list.

Warning banners

Below the bar, banners appear when something blocks operation:

  • Front proxy (ports 80/443) failed to start: the banner names the reason, for example another program on the ports. Retry starts the proxy again. If another program holds the ports, Free ports 80/443 quits it and starts the proxy. If the DDEV router holds them, Move DDEV router moves it to other ports (for example 9080/9443), running DDEV projects restart briefly. The cross hides the banner.
  • If a service cannot start because its port is in use, the banner names the service, the port and the program holding it. Free port … (with the port number) quits that program and then starts the service. If a system process holds the port, WebDonkey cannot free it, and the banner says so. The cross hides the banner.

See also

Theme switcher Free

The theme switcher at the bottom of the sidebar shows the active theme with its icon and name. A click opens a menu upwards where you pick another theme. A theme sets the colours and look of the whole app.

How to do it

  1. Click the name of the active theme at the bottom of the sidebar, such as Aurora Dark.
  2. Pick a theme in the menu. The active one carries a check mark.
  3. The app switches at once, and the choice stays after a restart.

Esc or a click outside closes the menu without a change.

What the menu lists

Entry Meaning
Aurora Dark the dark default theme
Arctic Light the light theme
System follows the macOS setting (light or dark)
Premium presets themes that ship with the app, only in the menu with Premium
your themes themes you built or imported
Manage themes… opens the Themes page

With ⌘K

In the palette, Switch theme toggles between dark and light (Aurora Dark and Arctic Light). This switch is stored too. If you bound a shortcut to it, ⌘Z takes the switch back for five seconds, see Undo after a shortcut. The palette's Themes group lists the presets and your own themes to pick directly.

Free and Premium

The Premium presets only appear in the menu with Premium. If Premium ends while a Premium theme is active, the app returns to the default and shows Theme reset to Aurora.

See also

Bell and notifications Free

The bell at the top of the sidebar collects what finished while you were working elsewhere: an install, a backup, a download, a check. A number on the bell shows how many notifications you have not read yet. If WebDonkey is not in front, macOS also shows the notification as a banner.

Where to find it

The bell sits in the sidebar head to the right of the app name. In the collapsed sidebar it is hidden. Expand the sidebar to see it.

How to do it

  1. Click the bell. The Notifications list opens, newest at the top.
  2. Each row has an icon for its kind, a text and the time ("5 minutes ago"). Unread ones carry a dot.
  3. Click a notification. It then counts as read, and WebDonkey jumps to the matching page, such as the changelog for an update or the connection for a transfer.
  4. Esc or a click outside closes the list.

If there is nothing, the list says Nothing new. Finished downloads, backups and checks land here.

Fields and options

Element Meaning
Number on the bell unread notifications, from 100 on shown as "99+"
Mark all as read (double check mark) marks everything as read, the number disappears
Clear all (bin) empties the list

What WebDonkey tells you about

Kind When
Package installed A service such as PHP or MySQL has finished installing.
Update available A new version of WebDonkey or of a package is ready.
Backup created A scheduled backup has run.
Scheduled task ran A scheduled task has finished, successfully or not.
Process aborted A background process crashed or was stopped.
AI model ready An AI model has finished downloading.
ISO downloaded An ISO image for a virtual machine is ready.
Mail in Mailpit A new mail has arrived in the local mailbox.
Monitoring A monitored site changed state, or a certificate is expiring.
Subscription due A subscription is about to charge, or its cancellation deadline is near.
Claude is waiting Claude Code needs your input or a permission. This needs its hook set up on the Claude page.
WebDonkey Editor found Once, after the WebDonkey Editor was installed.
Transfer finished A download or upload in the file manager of an SFTP connection has finished or failed.

A failed run of a workflow (Beta) lands here as well, if the workflow is set up that way.

What happens in the background

  • Notifications are stored and survive a restart.
  • WebDonkey keeps at most 200. Beyond that, the oldest read ones go first. Unread ones are never removed to make room. The list shows the newest 100.
  • If the WebDonkey window is in front, a notification only lands in the bell. Otherwise macOS also shows it as a banner.

Switching off

Under Settings › Notifications every kind has its own switch, plus a main switch for all of them. It takes effect at once: a kind that is off is not filed at all, neither in the bell nor as a macOS banner.

Troubleshooting

What you see Why What to do
The bell is missing The sidebar is collapsed Expand sidebar
An expected notification does not arrive The kind, or all notifications, are switched off Check Settings › Notifications
No macOS banner WebDonkey was in front, or macOS does not allow notifications from WebDonkey Check notifications in the macOS System Settings

See also

Report a problem Free

Report a problem (lifebuoy icon) sits in the sidebar footer below Search & commands. A click opens a small menu with two ways, because a question and a hard fault belong in different places.

How to do it

  1. Click Report a problem at the bottom of the sidebar.
  2. Pick a way:
    • Ask on Discord: for a small inconsistency, a question, or just a chat with others.
    • Report a fault in the shop: for a real, hard error you want tracked and answered. This opens the report form in the WebDonkey shop, in German if your interface is set to German.
  3. Both open in your default browser.

Esc or a click outside closes the menu.

With ⌘K

In the palette, the action Report a problem goes straight to the report form in the shop, without the menu.

Good reports

  • Describe what you did, what you expected and what happened.
  • Mention the WebDonkey version. It is shown at the top of the sidebar.
  • Look at the Logs: crashes and failed tasks are listed there, often with the exact reason.

See also

Changelog Free

The Changelog shows what changed in which version of WebDonkey: new features, improvements and fixed bugs. You reach it through the version number at the top of the sidebar.

Where to find it

  • In the sidebar head, below the app name, the version is shown with Changelog, such as v1.0.50 · Changelog. A click opens the page.
  • With ⌘K you find the entry Changelog in the Sidebar group.
  • A click on the Update available notification in the bell leads here as well.

How to read it

  1. Every published version has a card of its own, the newest at the top, with version number and date.
  2. Below are the changes of that version. Links in them open in the browser.
  3. The page loads eight versions first. Load more fetches the next eight.

The texts exist in German and English. If the interface is set to another language, the changelog shows the English version.

What happens in the background

  • The changelog comes from the WebDonkey server. The app needs an internet connection for it.
  • If the changelog lists a version newer than yours, WebDonkey checks for an update right away instead of waiting for the next regular check. If it finds one, the update dialog opens, see Updates.

Troubleshooting

What you see Why What to do
Could not reach the release server. No internet connection, or the server does not answer Open website opens the WebDonkey download page in the browser. Try again later
No releases published yet. The server returned no versions Open the page again later

See also

Page state Free

You can switch pages at any time without losing what you set or typed. When you come back, the page looks the way you left it. This page explains what is kept, for how long, and what deliberately is not.

What is kept when you switch pages

  • Tabs, filters, search boxes and sort order, such as the open tab of the settings or a search term under Services.
  • The selected row, such as a configuration file, a log or a database.
  • The scroll position of every page.
  • Half-filled forms, such as a new site or a scheduled task. An open dialog opens again too, with everything you had entered.
  • A message you started in the AI chat, attachments included.
  • Open SFTP and SSH connections on the SFTP / SSH page. The page stays open in the background as long as it holds connections, so terminals and sessions do not drop.

For how long

Most of this lasts until you quit WebDonkey. On the next start the pages begin fresh. That is on purpose: a search term or filter from yesterday would otherwise hide content without you knowing why.

What is explicitly a setting or work material survives a restart, for example:

  • the input in the Toolbox tools,
  • the dashboard layout,
  • the chosen AI model,
  • whether the sidebar is collapsed.

What is deliberately not kept

  • A running AI answer is cancelled when you leave the page. The finished messages of the chat stay.
  • Cancel or Close in a dialog throws the draft away at once.

When a page runs into an error

If a page runs into an error, the rest of the window stays usable. Instead of the page it then says This page ran into an error. with the error message below. Reload page reloads the window. Switching to another page works without reloading as well. If the error comes back, report it through Report a problem and include the message.

See also

Cookie preferences

This website uses cookies to ensure the best experience possible. Your choice applies to webdonkey.io and the shop at shop.webdonkey.io. More information...

Technically required

Cookies required for this website to function:

Always on
WebDonkey
WebDonkey
Provider: BuI Hinsche GmbH, Neumarkt 7, 06712 Zeitz, Germany
Purpose: Your consent, colour scheme and language for website and shop, price switches; with wd_debug in the address, the measurement events in the developer console for troubleshooting
Cookies and storage: Cookie wd_consent on .webdonkey.io, shared with shop.webdonkey.io (12 months); cookies wd_theme and wd_lang on .webdonkey.io, shared with shop.webdonkey.io, only when you switch colour scheme or language yourself (365 days); localStorage wd:consent, wd:theme, wd:lang; sessionStorage wd:acc, wd:term, wd:debug (only with wd_debug in the address; until the tab closes)

Statistics

Shows us which pages and products people look at on webdonkey.io and in the shop, where visitors come from and how they get to a purchase (with order number, amount and products, without name or email address). Provider: Google. Transfer to the USA possible (EU-US Data Privacy Framework). Your choice applies to webdonkey.io and the shop together.

Google Tag Manager, Google Analytics 4
Google Tag Manager
Provider: Google Ireland Limited, Gordon House, Barrow Street, Dublin 4, Ireland
Purpose: Loads the services you agreed to, here and in the shop. Sets no cookies of its own.
Cookies and storage: none
Privacy policy
Google Analytics 4
Provider: Google Ireland Limited, Gordon House, Barrow Street, Dublin 4, Ireland
Purpose: Usage statistics: page views, clicks, scroll depth, sources, devices, load times; in the shop also basket, checkout, purchases, registration and sign-in
Cookies and storage: _ga, _ga_<ID> (2 years)
Privacy policy

Marketing

Measures whether our ads on Facebook, Instagram and TikTok lead to visits and downloads on webdonkey.io and to registrations and purchases in the shop, and builds audiences for ads. Providers: Meta and TikTok, with whom we are jointly responsible for this. With this consent Google may also set advertising cookies (_gcl_…). Transfer to the USA and other countries outside the EU possible. Your choice applies to webdonkey.io and the shop together.

Google Tag Manager, Meta Pixel (Facebook, Instagram), TikTok Pixel
Google Tag Manager
Provider: Google Ireland Limited, Gordon House, Barrow Street, Dublin 4, Ireland
Purpose: Loads the services you agreed to, here and in the shop. Sets no cookies of its own.
Cookies and storage: none
Privacy policy
Meta Pixel (Facebook, Instagram)
Provider: Meta Platforms Ireland Limited, Merrion Road, Dublin 4, D04 X2K5, Ireland
Purpose: Ad measurement and target groups on Facebook and Instagram, also in the shop (basket, checkout, purchases, registration)
Cookies and storage: _fbp (3 months), _fbc (3 months, only if you arrive through an ad), fr on facebook.com (3 months)
Privacy policy
TikTok Pixel
Provider: TikTok Technology Limited, 10 Earlsfort Terrace, Dublin, D02 T380, Ireland
Purpose: Ad measurement and target groups on TikTok, also in the shop (basket, checkout, purchases, registration)
Cookies and storage: _ttp, _tt_enable_cookie (13 months)
Privacy policy