From 53219bf82751db700bf66087b889444126ca187f Mon Sep 17 00:00:00 2001
From: "Bobby R. Bruce" <bbruce@ucdavis.edu>
Date: Wed, 4 Oct 2023 18:48:55 -0700
Subject: [PATCH] util: Add Troubleshooting for "Vagrant failed..."

Change-Id: I01e637f09084acb6c5fbd7800b3e578a43487849
---
 util/github-runners-vagrant/README.md | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/util/github-runners-vagrant/README.md b/util/github-runners-vagrant/README.md
index ea7fd16957..ca504e3c63 100644
--- a/util/github-runners-vagrant/README.md
+++ b/util/github-runners-vagrant/README.md
@@ -86,3 +86,15 @@ virsh pool-define default-pool.xml # From here we re-add the default.
 virsh pool-start default
 virsh pool-autostart default
 ```
+
+### Error: "Vagrant failed to initialize at a very early stage"
+
+W set the `VAGRANT_HOME` environment variable to the CWD.
+It's likely this has become unset The solution is simple.
+Within the directory containing "Vagrantfile":
+
+```sh
+VAGRANT_HOME=`pwd` vagrant <command>
+```
+
+You may want to set `VAGRANT_HOME` in your .bashrc or .zshrc.