Dashboard
FreeThe dashboard is the start page and the overview of everything listed below it in the sidebar. It consists of tiles, the widgets, which you arrange and resize freely. Each widget shows the state of a page and takes you there with one click.
What you do here
- Widgets in the dashboard: what there is and what each tile shows
- Customizing the board: add, move, resize, configure and remove tiles
- macOS widgets: WebDonkey's state on the desktop and in Notification Center
Page layout
- At the top right Customize, which turns on edit mode. In edit mode the button reads Done, with Full board and Reset next to it.
- Below it the grid with three columns. A tile is one to three columns wide and one or two rows high.
- A fresh board shows Status, Sites, Services, Quick actions, Workflows and Claude.
Your layout stays saved, also after a restart.
Free and Premium
The dashboard is the same in Free and Premium. The widgets of the Remote pages (SFTP / SSH, Remote backups, Remote cron jobs, Remote logs) show a hint with Upgrade instead of data in Free. The Project backups and Notes widgets also belong to Premium pages.
Widgets in the dashboard Free
Every widget is a tile that shows the state of a page. Many have buttons of their own, for example to start all services or to switch the PHP version. The arrow in a tile's header (View all) opens the matching page.
Where to find it
Sidebar Dashboard. What is not on the board yet you find in edit mode under Add widget:, see Customizing the board.
The catalog
Local
| Widget | What it shows |
|---|---|
| Status | the overall state in one sentence: Everything is running, n of m services running, Your dev environment is paused or A service needs attention. Plus Services active, the number of Sites, the Monitor and the State. Restart restarts all services and the front proxy. |
| Services | all services with their state |
| Sites | your local projects. Without a site it says No sites yet. |
| Quick actions | Start all, Stop all, New site and Search & commands (⌘K) |
| Monitor | monitored targets and whether they are reachable |
| Subscriptions | the total per month and the next renewals of your subscriptions |
| Scheduled tasks | the active tasks, the next one first |
| DDEV & Docker | running DDEV projects and Docker containers. Without either: Neither DDEV nor Docker detected. |
| Toolbox | shortcuts to tools of the toolbox |
| Databases | the database servers with the number of their databases |
| Certificates | the SSL certificates of your sites |
| Project backups | your backup sets with their schedule and the Back up now button |
| Notes | the latest notes. A click opens Notes. |
| Mail inbox | the mails caught by Mailpit, with n caught messages. If Mailpit is not running, it says so. |
| Updates | available updates with the old and new version, otherwise Everything up to date. |
| PHP version | the Active CLI version and a button per installed version to switch |
| SSH hosts | your SSH host shortcuts from the terminal, each with Copy ssh command |
| Sandbox | the folder where WebDonkey keeps its services and data, with Open in Finder |
Remote
| Widget | What it shows |
|---|---|
| SFTP / SSH | your connections, open sessions first and marked Session open. A click connects or brings the open tab to the front. |
| Remote backups | your server backups with the last and next run, failed ones first |
| Remote cron jobs | the cron jobs on your servers |
| Remote logs | your remote logs |
Tools
| Widget | What it shows |
|---|---|
| Workflows | your workflows, each with a button to start it |
| Claude | usage against the 5-hour and the weekly limit with the time until reset, in every size, plus the running instances. If Claude Code is not set up, a button leads to the Claude page. |
| AI | whether Ollama is running, which model is in memory and how many models are on disk |
| Virtual machines | your virtual machines, running ones first, with Start and Stop |
Settings per widget
Some widgets have a gear in edit mode (Widget settings):
| Widget | Settings |
|---|---|
| Services | Entries shown, Show only these services |
| Sites | Entries shown, Show only these sites |
| Monitor | Entries shown, Project (or All), Only show problems |
| SFTP / SSH | Entries shown, Show only these connections |
| Toolbox | Shortcuts: which tools the tile shows |
| Subscriptions, Scheduled tasks, Notes, Mail inbox, Remote backups, Remote cron jobs, Remote logs, Workflows, Virtual machines | Entries shown |
How many entries a tile shows also depends on its height. A tile never scrolls, it shows as much as fits.
Notes
- Widgets of pages you hid under Settings › Navigation are neither shown nor offered. When you show a page again, its widget returns at a free spot.
- The widgets of the Remote pages show a hint and Upgrade, which leads to the Premium page, instead of data in Free. With Hide Premium features they are not offered at all.
See also
Customizing the board Free
In edit mode you put the dashboard together: add tiles, move them, change their size, configure and remove them. Your layout stays saved, also after a restart.
Where to find it
Sidebar Dashboard, Customize at the top right. Done ends edit mode.
How to do it
- Click Customize. The tiles get a dashed border, and the Add widget: bar appears above the board.
- Click a widget in the bar. It lands at the first free spot. Or drag it to the cell where it should go.
- Grab a tile by its title bar and drag it to the target cell. Whatever is in the way slides down.
- Click the size in a tile's header, such as
2×1, and pick the new size. - Click Done.
Fields and options
| Element | Effect |
|---|---|
| Size (Width) | opens the choice of sizes: 1 to 3 columns wide, 1 or 2 rows high. Each choice shows its area in the grid. |
| Gear (Widget settings) | opens the widget's settings, such as Entries shown or Only show problems. Done closes the dialog. Only for widgets that have settings. |
| × (Delete) | takes the tile off the board. It then shows in Add widget: again. |
| Add widget: | all widgets not on the board yet. If everything is already there, it says Everything is on the board. |
| Full board | lays out a wide arrangement with most widgets. The widgets of Premium pages stay in the catalog. |
| Reset | restores the default arrangement: Status, Sites, Services, Quick actions, Workflows and Claude. |
Which settings each widget has is listed under Widgets in the dashboard.
What happens in the background
- Gaps in the grid are allowed. Completely empty rows are dropped, and everything below moves up.
- WebDonkey saves the layout on this Mac.
- If a page is hidden under Settings › Navigation, its widget is missing from the board. Its spot is not kept: when you show the page again, the widget comes back at a free spot.
Troubleshooting
- Empty board: you removed all tiles. A click on the area opens edit mode, then add widgets or use Reset.
- A widget is missing from the catalog: its page is hidden under Settings › Navigation, or Hide Premium features is on.
Tip
Start with Full board, remove what you do not need, and make the most important tiles large.
See also
macOS widgets Free & Premium
WebDonkey comes with widgets for the desktop and Notification Center (macOS 14 or newer). They show the app's state without opening its window: services, sites, problems, databases, certificates, backups, mail, SSH connections, notes, PHP, Monitor, subscriptions, workflows, Claude, local AI and virtual machines. Some have buttons that act right away.
Where to find it
Right-click the desktop, Edit Widgets, then search for WebDonkey. The access for the widgets is in WebDonkey under Settings › System in the macOS widgets section.
How to do it
- In WebDonkey, open Settings › System › macOS widgets.
- If it says No Full Disk Access, click Open System Settings and turn the access on for WebDonkey. The section then reports Full Disk Access granted.
- Right-click the desktop, Edit Widgets, search for WebDonkey.
- Pick a widget and a size and drag it onto the desktop.
If WebDonkey does not show up in the gallery, launch the app once and open the gallery again.
The widgets
| Widget | Sizes | What it shows |
|---|---|---|
| Service Status | small, medium | all services and the front proxy at a glance |
| Problems | small, medium | only crashed services, failed jobs and expiring certificates |
| Quick Actions | medium | Start All, Stop All and Proxy (restarts the front proxy) |
| My Sites | medium, large | your local sites. A tap opens one in the browser. |
| Cron Monitor | small, medium | the next scheduled job and the last run's result |
| Mailpit Inbox | small, medium | test mails caught by Mailpit |
| Databases | medium | database servers, ports and database counts |
| Certificate Watch | small, medium | which site certificate expires next |
| SSH Connections | medium | your saved remote connections |
| Backup Status | small, medium | last and next run of your project backup sets |
| Tool Updates | small | available updates for PHP, NGINX, MySQL and friends |
| Recent Notes | medium | your most recently edited notes |
| PHP Version | medium | the active CLI PHP and a button per installed version to switch |
| Monitor | small, medium | whether a monitored site is down right now |
| Subscriptions | small, medium | monthly cost and the next renewals |
| Toolbox | small, medium | one tap into JSON, regex, colours and more |
| Workflows | small, medium | last runs, next start, and a tap runs a workflow |
| Claude | small, medium | usage against the 5-hour and weekly limit, and the open sessions |
| Remote Backups | small, medium | last and next run of your server backups, failures first |
| Remote Cron | small, medium | next start and last result of the cron jobs on your servers |
| Local AI | small, medium | whether Ollama is running and which model is in memory |
| Virtual Machines | small, medium | which virtual machines are running right now |
A tap on a widget opens the matching page in WebDonkey. The buttons of Quick Actions, PHP Version and Workflows take effect within a few seconds. PHP Version switches the CLI PHP, terminal included; your sites keep their own version.
What happens in the background
- WebDonkey writes its state about every 30 seconds into a shared store that the widgets read. macOS refreshes the widgets on its own schedule, right away after an action from a widget.
- A tap on a button puts an order into this store, and WebDonkey picks it up within two seconds.
- WebDonkey has to be running. If no new state arrives for a few minutes, the widgets show WebDonkey isn't running instead of outdated green lights.
- The widgets wear the theme the app is currently showing.
- Nothing leaves your Mac.
Why Full Disk Access
macOS only opens the shared store permanently to an app like WebDonkey with Full Disk Access. Without it, macOS would ask on every launch whether WebDonkey may access data from other apps. That is why WebDonkey only touches the store once you have granted the access. After that macOS never asks again. A WebDonkey widget on your desktop gets data within a minute.
Free and Premium
The widgets SSH Connections, Remote Backups, Remote Cron, Recent Notes and Backup Status belong to Premium features. In Free they show, instead of data, that this is a Premium feature. All other widgets work in Free.
Troubleshooting
| What you see | What you do |
|---|---|
| All widgets show WebDonkey isn't running although the app is running | Grant Full Disk Access under Settings › System › macOS widgets |
| Launch the app once to populate widgets | Open WebDonkey once |
| A widget looks frozen | Remove the widget and add it again |
| WebDonkey is missing from the gallery | Launch the app once and open the gallery again |