diff --git a/helm/README.md b/helm/README.md
index 1a3428b5e601de0c6c33f9dab236321e95592c6c..6edbee94702136fe7d98b01b3a653b191132955c 100644
--- a/helm/README.md
+++ b/helm/README.md
@@ -9,6 +9,8 @@ helm dependencies update .
 helm install theodolite .
 ```
 
+**Hint for Windows users:** The Theodolite Helm chart makes use of some smylinks. These are not properly created when this repository is checked out with Windows. There are a couple of solutions presented in this [Stack Overflow post](https://stackoverflow.com/q/5917249/4121056). A simpler workaround is to manually delete the symlinks and replace them by the files and folders, they are pointing to. The relevant symlinks are `benchmark-definitions` and the files inside `crd`.
+
 ## Customize Installation
 
 As usual, the installation with Helm can be configured by passing a values YAML file:
diff --git a/theodolite/README.md b/theodolite/README.md
index e0d7b9b46473a877d982e912cb85e2455e09be79..60bd56d933d8955217120465c47e70b4b34585e1 100644
--- a/theodolite/README.md
+++ b/theodolite/README.md
@@ -12,6 +12,15 @@ You can run your application in dev mode using:
 ./gradlew quarkusDev
 ```
 
+### Hint for running with k3s (or k3d)
+
+You may need to add the following dependencies to the `build.gradle` file when running Theodolite with k3s.
+
+```
+implementation 'org.bouncycastle:bcprov-ext-jdk15on:1.68'
+implementation 'org.bouncycastle:bcpkix-jdk15on:1.68'
+```
+
 ## Packaging and running the application
 
 The application can be packaged using: