diff --git a/aider/website/docs/install/install.md b/aider/website/docs/install/install.md
index e693df72e..70a9b5754 100644
--- a/aider/website/docs/install/install.md
+++ b/aider/website/docs/install/install.md
@@ -31,7 +31,7 @@ To work with Anthropic's models like Claude 3.5 Sonnet you need a paid
 
 ```
 # Install aider
-python -m pip install -U --ignore-installed aider-chat
+python -m pip install -U --upgrade-strategy only-if-needed aider-chat
 
 # To work with GPT-4o:
 $ aider --4o --openai-api-key sk-xxx...
@@ -44,7 +44,7 @@ $ aider --sonnet --anthropic-api-key sk-xxx...
 
 ```
 # Install aider
-python -m pip install -U --ignore-installed aider-chat
+python -m pip install -U --upgrade-strategy only-if-needed aider-chat
 
 # To work with GPT-4o:
 $ aider --4o --openai-api-key sk-xxx...
diff --git a/aider/website/docs/troubleshooting/imports.md b/aider/website/docs/troubleshooting/imports.md
index 182f107f5..e430cbd06 100644
--- a/aider/website/docs/troubleshooting/imports.md
+++ b/aider/website/docs/troubleshooting/imports.md
@@ -20,6 +20,13 @@ If you are having dependency problems you should consider
 This will ensure that aider is installed in its own python environment,
 with the correct set of dependencies.
 
+Try re-installing cleanly:
+
+```
+pipx uninstall aider-chat
+pipx install aider-chat
+```
+
 ## Package managers like Homebrew, AUR, ports
 
 Package managers often install aider with the wrong dependencies, leading
@@ -28,11 +35,11 @@ to import errors and other problems.
 The recommended way to 
 install aider is with 
 [pip](/docs/install/install.html).
-Be sure to use the `--ignore-installed` switch so that the correct
+Be sure to use the `--upgrade-strategy only-if-needed` switch so that the correct
 versions of dependencies will be installed.
 
 ```
-python -m pip install -U --ignore-installed aider-chat
+python -m pip install -U --upgrade-strategy only-if-needed aider-chat
 ```
 
 A very safe way is to