Yard Docs
Sign in

YRD-DATADIR-001: The workspace folder cannot be used

The folder chosen for workspaces cannot be written, or the container engine cannot see it.

Updated November 11, 2026 ยท 1 min read

Error YRD-DATADIR-001. Yard keeps workspaces in one folder (~/.yard by default, %USERPROFILE%\yard on Windows without containers). That folder cannot be used.

Fix it

  • It is not empty: Yard only uses a new folder, an empty one, or one Yard used before, so it never mixes into your own files. Pick a new folder.
  • It cannot be written: pick a folder in your own home, not a system folder or a read-only drive.
  • Docker cannot see it (Mac): Docker Desktop shares /Users by default. A folder on another disk must be added under Docker Desktop โ†’ Settings โ†’ Resources โ†’ File sharing.
  • A network drive or a cloud-synced folder (OneDrive, iCloud Drive, Dropbox) is slow and can corrupt Git: use a local folder.
Was this page useful?
Edit this page