summaryrefslogtreecommitdiffhomepage
diff options
context:
space:
mode:
-rw-r--r--test/docs/BUILD_OS_IMAGE.md9
1 files changed, 9 insertions, 0 deletions
diff --git a/test/docs/BUILD_OS_IMAGE.md b/test/docs/BUILD_OS_IMAGE.md
index 659eb7d55e..9331e8924c 100644
--- a/test/docs/BUILD_OS_IMAGE.md
+++ b/test/docs/BUILD_OS_IMAGE.md
@@ -218,6 +218,15 @@ Windows Defender ocasionally kills the `test-runner` because it believes it to b
Now you are done! If the VM was configured correctly, `test-manager` will be able to run the test suite using the new OS image.
Now you should [add your new VM to the test-manager config](./test-manager/README.md#configuring-test-manager)
+## Notes on editing Windows VM images
+
+When editing the VM image, never shut it down with the test runner volume mounted (i.e. `E:`). When
+Windows is shut down with the disk mounted, it will be unable to remount it correctly when the image
+is replaced.
+
+To get around this behavior, remove the disk from your VM config before starting it with
+`--keep-changes`.
+
# macOS 🚧
_Instructions for building an OS image based on macOS are still under construction._