Window and navigation
FreeThe 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
- Switch between pages: Sidebar.
- Start, stop or restart all services and create a site: Top bar.
- Change the look: Theme switcher.
- See what has finished: Bell and notifications.
- Ask a question or report a fault: Report a problem.
- Read what changed in which version: Changelog.
- Understand what stays when you switch pages: Page state.
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.
Sidebar Free
The sidebar is WebDonkey's main navigation. It groups all pages by where the work happens: on this Mac, on your servers, watching websites, with tools, around your account and help. A click on an entry opens the page, the active entry is highlighted.
Layout
Head
At the top are the logo and the app name. Below them is the running version with Changelog, such as v1.0.50 · Changelog. A click on it opens the changelog. To the right sits the bell with the number of unread notifications.
The groups
| Group | Entries |
|---|---|
| (no heading) | Dashboard |
| Local | Sites, SSL certificates, Services, Configuration, Databases, Mail, Logs, Backups, Scheduled tasks |
| Remote | SFTP / SSH, Databases, Backups, Cron jobs, Logs, Mail, Fetch locally |
| Monitoring | Monitor, SEO |
| Tools | Terminal, API client, Workflows (Beta), Toolbox, AI, Claude, MCP, Notes, Virtual machines (Beta), Subscriptions |
| Account & Help | Themes, Documentation, Legal, on Free also Premium |
The dashboard sits at the very top without a heading because it is the overview of the groups below. The remote pages work on your servers over SSH. Their icons differ from the local pages of the same name, so you can tell them apart in the collapsed sidebar too.
Workflows and Virtual machines carry the Beta badge: they work, but are not fully mature yet.
If the active entry sits lower than the window is tall, the sidebar scrolls by itself until it is in view.
Footer
The footer is always visible and does not scroll:
- Settings opens the settings.
- Search & commands with the shortcut ⌘K opens the palette.
- Report a problem leads to Discord or to the report form, see Report a problem.
- The theme switcher shows the active theme.
- Collapse sidebar makes the sidebar narrow.
Collapsed
With Collapse sidebar only a narrow strip of icons remains. Hovering an icon shows its name in a tooltip, for the remote pages the full name (for example Remote databases). Thin lines separate the groups instead of headings. Version, changelog link and bell are hidden while collapsed. Expand sidebar brings the full width back. WebDonkey remembers the choice across restarts.
Locks and badges
- SEO carries a lock as long as you lack the SEO package. The tooltip names the package. The page explains what the package unlocks, see SEO package.
- SFTP / SSH and the remote pages Databases, Backups, Cron jobs, Logs and Mail are Premium, as are Backups and Notes under Local and Tools. Fetch locally is free.
Customising
Under Settings › Navigation you hide pages you never need. They disappear from the sidebar, from ⌘K and from the dashboard's widget catalogue, but stay reachable by link. On Free, Hide Premium features hides the Premium pages in one go. Dashboard and the Premium entry cannot be hidden.
See also
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
- Click the name of the active theme at the bottom of the sidebar, such as Aurora Dark.
- Pick a theme in the menu. The active one carries a check mark.
- 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
- Click the bell. The Notifications list opens, newest at the top.
- Each row has an icon for its kind, a text and the time ("5 minutes ago"). Unread ones carry a dot.
- 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.
- 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
- Click Report a problem at the bottom of the sidebar.
- 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.
- 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
- Every published version has a card of its own, the newest at the top, with version number and date.
- Below are the changes of that version. Links in them open in the browser.
- 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.