From d7cec0d2d94569c458e1525f14eabe93863c20ac Mon Sep 17 00:00:00 2001
From: Oliver Henze <oliver.henze@ptb.de>
Date: Fri, 19 Jan 2024 11:47:50 +0000
Subject: [PATCH] ADD Tutorial for conda/mamba on servers

---
 README.md | 30 +++++++++++++++++++++++++-----
 1 file changed, 25 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index 230f0cc..19cb27b 100644
--- a/README.md
+++ b/README.md
@@ -1,9 +1,29 @@
 # conda-configuration-8-4
 
 Small tutorial with starting steps and templates for using **conda/mamba** on the servers of Fachbereich 8.4
+---
 
-- miniforge under Windows -> Softwarecenter
-- use either system python installation or install custom versions via **conda/mamba**
-- change template `.condarc` to desired directories for saving packages and environments
-- revert previous bash etc. initalisations via `conda init --reverse`
-- central location for **conda/mamba** executables **on servers only**
\ No newline at end of file
+If you are using *Windows*, you can find the "official" PTB **miniforge** installation in the *Softwarecenter*
+---
+On the compute servers, a central installation of both **conda** and **mamba** is provided. **mamba** is functionally identical to **conda**, it is just a faster reimplementation in *C++*, use whichever you prefer, the commands are identical.
+
+The executables of both programs are located in the `/home/admin84/shared_public`, which should be configured on all servers the be included in `$PATH`. You can verify you are using the correct executable by running `conda info`. If this returns a different location than above, please remove your personal previous installation of (ana)**conda** first. 
+
+If you have used **conda** before, you have update you **bash** initialisation first by running
+
+```
+conda init --reverse
+conda init
+```
+
+You can use the `.condarc` template provided here to customise the locations where your environments and package caches are located when using **conda**. Please consider using the *san* for you paths to avoid cluttering the local drives. 
+
+**Conda** will be default use the *python* version which is installed on the host machine, but you can use any supported version when creating new environments, e.g. 
+
+```
+mamba create python=3.12 numpy ipython --name mamba-test
+```
+.
+The default channel configured is *conda-forge*, which is still permitted by PTB. Please do not override this when creating new environments unless you are 100% certain that the licence of the channel in question permits use by PTB. When in doubt, please ask.
+
+If any problems arise or you have further questions, please contact [me](oliver.henze@ptb.de) and I will amend this document with clarifications and answer questions.
\ No newline at end of file
-- 
GitLab