From db5a055d6d05d2727bcc51fd7f7fdffd155192b5 Mon Sep 17 00:00:00 2001
From: MilesCranmer <miles.cranmer@gmail.com>
Date: Wed, 14 Aug 2024 22:34:19 +0100
Subject: [PATCH] docs: add back troubleshooting

---
 README.md | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/README.md b/README.md
index 31fd9dbd9..aa1801933 100644
--- a/README.md
+++ b/README.md
@@ -130,6 +130,29 @@ apptainer run pysr.sif
 
 </details>
 
+<details>
+<summary>
+
+### Troubleshooting
+
+</summary>
+
+One issue you might run into can result in a hard crash at import with
+a message like "`GLIBCXX_...` not found". This is due to another one of the Python dependencies
+loading an incorrect `libstdc++` library. To fix this, you should modify your
+`LD_LIBRARY_PATH` variable to reference the Julia libraries. For example, if the Julia
+version of `libstdc++.so` is located in `$HOME/.julia/juliaup/julia-1.10.0+0.x64.linux.gnu/lib/julia/`
+(which likely differs on your system!), you could add:
+
+```
+export LD_LIBRARY_PATH=$HOME/.julia/juliaup/julia-1.10.0+0.x64.linux.gnu/lib/julia/:$LD_LIBRARY_PATH
+```
+
+to your `.bashrc` or `.zshrc` file.
+
+</details>
+
+
 ## Quickstart
 
 You might wish to try the interactive tutorial [here](https://colab.research.google.com/github/MilesCranmer/PySR/blob/master/examples/pysr_demo.ipynb), which uses the notebook in `examples/pysr_demo.ipynb`.