Yard Docs
Sign in
On this page

YRD-IMAGE-001: The workspace image could not be prepared

Downloading or building the image every workspace starts from failed.

Updated November 11, 2026 ยท 1 min read

Error YRD-IMAGE-001. Every workspace container starts from one image (about 4 GB once unpacked). Preparing it failed, most often because the download was cut off or the disk filled up.

Fix it

  • Yard for desktop: press Try again. The parts already downloaded are kept.
  • In a terminal: yard runner setup --rebuild.

If it keeps failing

  • Check free space: see YRD-DISK-001.
  • A company proxy or VPN can block the download: try another network once.
  • Docker Desktop must be running: see YRD-DOCKER-002.
Was this page useful?
Edit this page