Yard Docs
Sign in
On this page

YRD-SERVICE-001: Yard could not start in the background

The background service that keeps this computer online did not start.

Updated November 11, 2026 ยท 1 min read

Error YRD-SERVICE-001. Yard runs in the background (a launch agent on a Mac, a scheduled task on Windows, a systemd unit on Linux) so your workspaces stay online after you close the app. That service did not start.

Fix it

  • Yard for desktop: press Restart Yard.
  • In a terminal: yard runner service status says what the service manager reports and shows the last log lines; yard runner service install installs it again.

Common causes

  • Linux, a dedicated account without a login session: user services need lingering, loginctl enable-linger <user>. See Connect a runner.
  • The runner exits at once with code 78: its token was refused, see YRD-TOKEN-001.
  • Mac, after moving the app: open Yard for desktop once from its new place so the service points at it.
Was this page useful?
Edit this page