Skip to main content

Watchdog for Workbench

Watchdog automatically relaunches Workbench if it crashes, disconnects, or stops responding, so you can reconnect without needing to be physically at the remote machine.

Quick facts

  • Runs in the background: Monitors the connection without any manual intervention needed

  • Built for unattended setups: Designed for the reality that a lot of Workbench machines aren't sitting in front of anyone

  • Opt-out: On by default but easy to turn off in Workbench settings

How Watchdog Works

Once you've launched Workbench on a machine at least once, Watchdog starts running in the background on that machine. From then on, it keeps checking in, and if the app crashes, freezes, or stops responding, it relaunches it automatically. This also means it can let another one of your devices restart it remotely, so you're not stuck waiting for someone to walk over and fix it in person.

One thing worth knowing: Watchdog only becomes active after Workbench has been opened at least once on that machine. Until then, there's nothing running in the background, yet.

What You'll See When it Kicks In

When a remote machine's Workbench app isn't responding, any device trying to connect to it will show a Relaunch button in place of the usual Connect button.

Session responding normally

Session needs a relaunch

Tapping Relaunch sends the command to restart Workbench on that machine, and the device list updates once it's back online.

Manually Forcing a Relaunch

Separate from the automatic Watchdog behavior, every Workbench app (Mac, iPhone, and iPad) has a small arrow icon that lets you manually force a relaunch at any time, even if Watchdog hasn't stepped in on its own yet. This is useful if a connection feels stuck or isn't behaving as expected, and you don't want to wait.

You may also see this prompt come up on its own: if a connection attempt spins for 10 to 15 seconds without connecting, the app will ask if you'd like to retry or force a relaunch, since the remote machine's app may be hung. This is expected behavior and usually resolves the connection right away.

Will I Receive a Notification that Watchdog is Turned On?

No. Watchdog does not send a notification. It simply relaunches the Workbench app on the remote Mac when it detects the app has hung or stopped responding, so the connection can be recovered without anyone needing to be at the main Mac.

This is part of the same Automatic Recovery behavior described below, which is on by default and can be turned off in Workbench settings.

Turning Watchdog Off

Watchdog is controlled by the Automatic Recovery setting.

To turn it off:

  1. Open Workbench settings on the remote machine

  2. Go to Remote Access

  3. Toggle off Automatic Recovery

To turn it back on:

  1. Open Workbench settings on the remote machine

  2. Go to Remote Access

  3. Toggle on Automatic Recovery

Automatic Recovery Settings

Turning this off stops the background helper entirely. That means the machine won't relaunch itself if it crashes or stops responding, and it also won't be able to be restarted remotely from another device. Most customers will want to leave this on, especially for machines that aren't attended in person, but it's there to turn off if needed.

Did this answer your question?