WSL troubleshooting - init_catalog.sh file not found (#219)

* WSL troubleshooting - init_catalog.sh file not found * Minor rewording Co-authored-by: Christian Kadner <[email protected]>
machine-learning-exchange · Sep 22, 2021 · 025a979 · 025a979
1 parent 7284aa5
commit 025a979
Showing 1 changed file with 16 additions and 0 deletions.
diff --git a/quickstart/README.md b/quickstart/README.md
@@ -101,3 +101,19 @@ To remove all previously created Docker Compose data run the following commands:
     docker compose down -v --remove-orphans
     docker compose rm -v -f
     docker volume prune -f
+
+### Windows Subsystem for Linux (WSL) Issues
+
+#### Featured Assets Pages are Empty
+
+If there are no featured asset cards showing up in the MLX web UI and the Docker Compose log shows an error like this:
+
+    catalog_1     | /bin/sh: /init_catalog.sh: not found
+    catalog_1 exited with code 127
+
+Make sure you originally cloned/forked the source repo from inside the WSL sub-system, not Windows. This error happens
+because the MLX source files have Windows line endings (`\r\n` - CRLF) which `bash` cannot run.
+(https://askubuntu.com/questions/966488/how-do-i-fix-r-command-not-found-errors-running-bash-scripts-in-wsl#comment1553686_966488).
+This error in the `catalog_1` service prevents the loading of assets and objects into the MLX catalog.
+
+