Dave Jarvis' Repositories

git clone https://repo.autonoma.ca/repo/keenwrite.git

Adds container troublesheeting section

AuthorDaveJarvis <email>
Date2025-09-07 13:12:31 GMT-0700
Commit8dfa39a3889ff36ccb4f62ba89354f9ed367f302
Parentadeb4f4
Delta28 lines added, 0 lines removed, 28-line increase
docs/15-troubleshooting.md
context about what the application was doing when problems occurred.
+## Container
+
+If you encounter the following error (or similar) on Windows:
+
+> Error: unable to load machine config file: "json: cannot unmarshal
+> string into Go struct field MachineConfig.ImagePath of type define.VMFile"
+
+Complete the following steps to remove conflicting containers:
+
+1. Stop {{app.title}}.
+1. Uninstall podman.
+1. Delete `C:\Users\%USERNAME%\.config\containers`
+1. Delete `C:\Users\%USERNAME%\AppData\Roaming\containers`
+1. Open a command prompt.
+1. Run:
+ ``` dos
+ wsl -l -v
+ wsl --unregister podman-machine-default
+ podman -v
+ podman machine reset -f
+ ```
+1. Reboot.
+1. Start {{app.title}}.
+1. Retry exporting as a PDF file.
+
+Note that downloading the ConTeXt image can take several minutes and does
+not show a progress indicator. Be patient.
+
## SVG compatibility