From 5fa192f62c5749ed4bc7242909d08df34cc76150 Mon Sep 17 00:00:00 2001 From: jaimergp Date: Mon, 12 Aug 2024 11:07:27 +0200 Subject: [PATCH 1/4] Document conda-standalone install workarounds --- docs/user-guide/faq.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/docs/user-guide/faq.md b/docs/user-guide/faq.md index 869fa53b..a739914f 100644 --- a/docs/user-guide/faq.md +++ b/docs/user-guide/faq.md @@ -58,3 +58,20 @@ Before version 22.12, the CLI flag was `--experimental-solver`. We recommend you upgrade to `conda` 22.11 or above, and then `conda-libmamba-solver` 22.12 or above. See the [22.12.0 announcement post](https://github.com/conda/conda-libmamba-solver/releases/tag/22.12.0) for more details on how to upgrade. + +## I have an older `conda` and I can't install `conda-libmamba-solver` + +Since older `conda` versions only supported the `classic` solver, you might run into solver conflicts or too long installations if your `base` environment is too constrained. This becomes a "chicken-and-egg" problem where you'd need `conda-libmamba-solver` to update to a more recent `conda` with `conda-libmamba-solver`. + +Fortunately, there's a workaround thanks to the `conda-standalone` project. This is a single binary that bundles recent `conda` versions, with `conda-libmamba-solver` included. It's not a substitute for the full `conda` UX but it can help bootstrap and rescue conda installations. + +1. Download the most recent `conda-standalone` from its [Github Releases page](https://github.com/conda/conda-libmamba-solver/releases/latest). Make sure to pick the one for your operating system and platform. Once downloaded, rename it as `conda.exe`. +2. Write down the location of your `base` environment: `conda info --root`. +3. Write down the main preconfigured channel in your installation: `conda config --show channels`. This is usually `defaults` or `conda-forge`. +4. Go to the Downloads directory and run this command from your terminal. + +```console +conda.exe install -p "[path given by step 2]" -c [channel from step 3] "conda>=23.10" conda-libmamba-solver +``` + +Once ready, you'll have `conda-libmamba-solver` installed in your base environment and will be ready to use it as normal. From ff0ee76bca65346f5b3d87f6d4efbe98a47efc18 Mon Sep 17 00:00:00 2001 From: jaimergp Date: Mon, 12 Aug 2024 11:08:56 +0200 Subject: [PATCH 2/4] add news --- news/511-conda-standalone-install | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) create mode 100644 news/511-conda-standalone-install diff --git a/news/511-conda-standalone-install b/news/511-conda-standalone-install new file mode 100644 index 00000000..c9f01a4e --- /dev/null +++ b/news/511-conda-standalone-install @@ -0,0 +1,19 @@ +### Enhancements + +* + +### Bug fixes + +* + +### Deprecations + +* + +### Docs + +* Add installation workarounds FAQ with conda-standalone. (#505 via #511) + +### Other + +* From 9b7a7f0e4c237d5d23dccb568c33e18c43b01855 Mon Sep 17 00:00:00 2001 From: jaimergp Date: Tue, 20 Aug 2024 18:34:20 +0200 Subject: [PATCH 3/4] Apply suggestions from code review Co-authored-by: Jannis Leidel --- docs/user-guide/faq.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/user-guide/faq.md b/docs/user-guide/faq.md index a739914f..16714fa1 100644 --- a/docs/user-guide/faq.md +++ b/docs/user-guide/faq.md @@ -63,9 +63,9 @@ See the [22.12.0 announcement post](https://github.com/conda/conda-libmamba-solv Since older `conda` versions only supported the `classic` solver, you might run into solver conflicts or too long installations if your `base` environment is too constrained. This becomes a "chicken-and-egg" problem where you'd need `conda-libmamba-solver` to update to a more recent `conda` with `conda-libmamba-solver`. -Fortunately, there's a workaround thanks to the `conda-standalone` project. This is a single binary that bundles recent `conda` versions, with `conda-libmamba-solver` included. It's not a substitute for the full `conda` UX but it can help bootstrap and rescue conda installations. +Fortunately, there's a workaround thanks to the `conda-standalone` project. This is a single binary that bundles recent `conda` versions, with `conda-libmamba-solver` included. It's not a substitute for the full `conda` user experience but it can help bootstrap and rescue conda installations. -1. Download the most recent `conda-standalone` from its [Github Releases page](https://github.com/conda/conda-libmamba-solver/releases/latest). Make sure to pick the one for your operating system and platform. Once downloaded, rename it as `conda.exe`. +1. Download the most recent `conda-standalone` from its [Github Releases page](https://github.com/conda/conda-standalone/releases/latest). Make sure to pick the one for your operating system and platform. Once downloaded, rename it as `conda.exe`. 2. Write down the location of your `base` environment: `conda info --root`. 3. Write down the main preconfigured channel in your installation: `conda config --show channels`. This is usually `defaults` or `conda-forge`. 4. Go to the Downloads directory and run this command from your terminal. From 0e97c490eefc72053da3f6dec894119dab7e860c Mon Sep 17 00:00:00 2001 From: jaimergp Date: Tue, 20 Aug 2024 18:38:20 +0200 Subject: [PATCH 4/4] Disambiguate Windows / Unix executable conventions --- docs/user-guide/faq.md | 16 ++++++++++++---- 1 file changed, 12 insertions(+), 4 deletions(-) diff --git a/docs/user-guide/faq.md b/docs/user-guide/faq.md index 16714fa1..32aa90af 100644 --- a/docs/user-guide/faq.md +++ b/docs/user-guide/faq.md @@ -65,13 +65,21 @@ Since older `conda` versions only supported the `classic` solver, you might run Fortunately, there's a workaround thanks to the `conda-standalone` project. This is a single binary that bundles recent `conda` versions, with `conda-libmamba-solver` included. It's not a substitute for the full `conda` user experience but it can help bootstrap and rescue conda installations. -1. Download the most recent `conda-standalone` from its [Github Releases page](https://github.com/conda/conda-standalone/releases/latest). Make sure to pick the one for your operating system and platform. Once downloaded, rename it as `conda.exe`. +1. Download the most recent `conda-standalone` from its [Github Releases page](https://github.com/conda/conda-standalone/releases/latest). Make sure to pick the one for your operating system and platform. Once downloaded, rename it as `conda.exe` on Windows and `conda` on Linux / macOS. 2. Write down the location of your `base` environment: `conda info --root`. 3. Write down the main preconfigured channel in your installation: `conda config --show channels`. This is usually `defaults` or `conda-forge`. -4. Go to the Downloads directory and run this command from your terminal. +4. Go to the Downloads directory and run this command from your terminal: + +On Windows: + +```console +.\conda.exe install -p "[path given by step 2]" -c [channel from step 3] "conda>=23.10" conda-libmamba-solver +``` + +On Linux or macOS: ```console -conda.exe install -p "[path given by step 2]" -c [channel from step 3] "conda>=23.10" conda-libmamba-solver +./conda install -p "[path given by step 2]" -c [channel from step 3] "conda>=23.10" conda-libmamba-solver ``` -Once ready, you'll have `conda-libmamba-solver` installed in your base environment and will be ready to use it as normal. +Once the command succeeds, you'll have `conda-libmamba-solver` installed in your base environment and will be ready to use it as normal. You can delete the conda-standalone binaries.