diff --git a/images/mkdocs/.dockerignore b/images/mkdocs/.dockerignore
new file mode 100644
index 0000000000000..1d1fe94df4921
--- /dev/null
+++ b/images/mkdocs/.dockerignore
@@ -0,0 +1 @@
+Dockerfile
\ No newline at end of file
diff --git a/images/mkdocs/Dockerfile b/images/mkdocs/Dockerfile
index 32c0c69df9adf..749c61330a7f5 100644
--- a/images/mkdocs/Dockerfile
+++ b/images/mkdocs/Dockerfile
@@ -14,7 +14,7 @@
 
 FROM alpine:3.10
 
-RUN apk update && apk add --no-cache \
+RUN apk add --no-cache \
   bash \
   git \
   git-fast-import \
@@ -22,6 +22,7 @@ RUN apk update && apk add --no-cache \
   python3 \
   python3-dev \
   curl \
+  build-base \
   && python3 -m ensurepip \
   && rm -r /usr/lib/python*/ensurepip \
   && pip3 install --upgrade pip setuptools \
diff --git a/images/mkdocs/requirements.txt b/images/mkdocs/requirements.txt
index 3b76bcdb731a5..c8562ad778607 100644
--- a/images/mkdocs/requirements.txt
+++ b/images/mkdocs/requirements.txt
@@ -1,5 +1,4 @@
-mkdocs-material~=4.4.0
-mkdocs~=1.0.4
-# mkdocs-awesome-pages-plugin~=1.2.0
-pymdown-extensions==6.2.1
-pygments~=2.3.1
\ No newline at end of file
+mkdocs-material~=5.2.3
+mkdocs~=1.1.2
+pymdown-extensions==7.1
+pygments~=2.6.1
diff --git a/mkdocs.yml b/mkdocs.yml
index 0858df5c02b0c..80b0ea87b6972 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -15,10 +15,11 @@ markdown_extensions:
       permalink: ' ¶'
 theme:
   name: material
-  feature:
-    tabs: true
-  logo:
-    icon: 'public'   # globe icon
+  features:
+    - tabs
+  icon:
+    logo: 'material/earth'
+  favicon: 'img/logo-notext.svg'
   palette:
     primary: 'teal'
     accent: 'green'
diff --git a/netlify.toml b/netlify.toml
index c7c3ed5421592..6c9d8ed6587b8 100644
--- a/netlify.toml
+++ b/netlify.toml
@@ -3,3 +3,5 @@
 publish = "site"
 command = "make build-docs-netlify"
 ignore = "git diff --quiet HEAD^ HEAD netlify.toml Makefile mkdocs.yml docs/ images/"
+# available here https://github.com/netlify/build-image/blob/xenial/included_software.md#languages
+environment = { PYTHON_VERSION = "3.7" }
\ No newline at end of file