diff --git a/README.md b/README.md
new file mode 100644
index 0000000..e7abfe8
--- /dev/null
+++ b/README.md
@@ -0,0 +1,24 @@
+# Legacy IDRAC6 KVM invoker
+
+On modern systems, the iDRAC6 remote console client is broken. This software
+helps to restore usability on linux based systems.
+
+## Common errors
+
+
+Connection failed
+* This java applet needs to be in the list of trusted Java applications
+* The Java security level must be patched down. This software requires RC4 to be available as tls crypto algorithm (really!)
+
+
+Patch java.security
+```
+sed -i -e '/^jdk.tls.disabledAlgorithms=/s/, RC4//' /etc/java-*-openjdk/security/java.security
+```
+
+
+Exception in thread "main" java.awt.AWTError: Assistive Technology not found
+
+```
+sudo sed -i -e '/^assistive_technologies=/s/^/#/' /etc/java-*-openjdk/accessibility.properties
+```