diff --git a/README.md b/README.md
index 21346a44..d5092202 100644
--- a/README.md
+++ b/README.md
@@ -54,6 +54,12 @@ T-Pot is the all in one, optionally distributed, multiarch (amd64, arm64) honeyp
- [Spiderfoot](#spiderfoot)
- [Maintenance](#maintenance)
- [Updates](#updates)
+ - [Update from 20.06.x](#update-from-2006x)
+ - [Updates for 22.04.x](#updates-for-2204x)
+ - [Known Issues](#known-issues)
+ - [Grub Fails to Reconfigure](#grub-fails-to-reconfigure)
+ - [Docker Images Fail to Download](#docker-images-fail-to-download)
+ - [Network Interface Fails](#network-interface-fails)
- [Start T-Pot](#start-t-pot)
- [Stop T-Pot](#stop-t-pot)
- [T-Pot Data Folder](#t-pot-data-folder)
@@ -553,13 +559,78 @@ The update script will ...
- ensure all T-Pot relevant system files will be patched / copied into the original T-Pot state
- restore your custom ews.cfg and HPFEED settings from `/data/ews/conf`
-You simply run the update script ***after you backed up any relevant data***:
+
+### **Update from 20.06.x**
+If you are running T-Pot 20.06.x you simply follow these commands ***after you backed up any relevant data***:
+```
+sudo su -
+cd /opt/tpot/
+wget -O update.sh https://raw.githubusercontent.com/telekom-security/tpotce/master/update.sh
+./update.sh
+```
+
+### **Updates for 22.04.x**
+If you are already running T-Pot 22.04.x you simply run the update script ***after you backed up any relevant data***:
```
sudo su -
cd /opt/tpot/
./update.sh
```
+## Known Issues
+The following issues are known, simply follow the described steps to solve them.
+
+
+### **Grub Fails to Reconfigure**
+In some cases Grub fails to reconfigure, follow these commands to correct that error:
+```
+sudo su -
+DEBIAN_FRONTEND=dialog dpkg --configure grub-pc
+```
+
+### **Docker Images Fail to Download**
+Some time ago Docker introduced download [rate limits](https://docs.docker.com/docker-hub/download-rate-limit/#:~:text=Docker%20Hub%20limits%20the%20number,pulls%20per%206%20hour%20period.). If you are frequently downloading Docker images via a single or shared IP, the IP address might have exhausted the Docker download rate limit. Login to your Docker account to extend the rate limit.
+```
+sudo su -
+docker login
+```
+
+### **Network Interface Fails**
+After the installation it is possible your network interfaces are using a different naming scheme (`ens` => `eth`). In this case you need to adjust `/etc/network/interfaces` to reflect your NIC.
+
+Example:
+```
+# This file describes the network interfaces available on your system
+# and how to activate them. For more information, see interfaces(5).
+
+source /etc/network/interfaces.d/*
+
+# The loopback network interface
+auto lo
+iface lo inet loopback
+
+# The primary network interface
+auto ens33
+iface ens33 inet dhcp
+```
+
+`ifconfig` / `ip a` revealed the interface is now named `eth0`, so you need to adjust `interfaces` accordingly:
+```
+# This file describes the network interfaces available on your system
+# and how to activate them. For more information, see interfaces(5).
+
+source /etc/network/interfaces.d/*
+
+# The loopback network interface
+auto lo
+iface lo inet loopback
+
+# The primary network interface
+auto eth0
+iface eth0 inet dhcp
+```
+
+
## Start T-Pot
The T-Pot service automatically starts and stops on each reboot (which occurs once on a daily basis as setup in `/etc/crontab` during installation).