diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 33a226de603535a6347f7fd1c5a5ec7f4a7e8765..59cb0de58a27d254e4998563682dec289aa72a7a 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -17,6 +17,7 @@ repos:
     hooks:
       - id: codespell
         name: Check source code spelling
+        args: [-L aks]
         stages: [commit]
 
   - repo: local
diff --git a/docs/sysadm/support-services/index.rst b/docs/sysadm/support-services/index.rst
index 40741e288814453f9cbfd28b1b6d83d9a9fb6a69..c5c136eb6687dcc2852d6a4b5fedccacc722a640 100644
--- a/docs/sysadm/support-services/index.rst
+++ b/docs/sysadm/support-services/index.rst
@@ -5,3 +5,4 @@ Support services
    :maxdepth: 2
 
    gitlab/index
+   rancher/index
diff --git a/docs/sysadm/support-services/rancher/howtos.rst b/docs/sysadm/support-services/rancher/howtos.rst
new file mode 100644
index 0000000000000000000000000000000000000000..749f9181d779e81a13edb4ab573c6071107379bb
--- /dev/null
+++ b/docs/sysadm/support-services/rancher/howtos.rst
@@ -0,0 +1,33 @@
+.. _rancher_howtos:
+
+.. admonition:: Intended audience
+   :class: important
+
+   sysadm staff members
+
+
+Rancher howtos
+==============
+
+How to connect to the underlying kubernetes
+-------------------------------------------
+
+- Add the following line in your `/etc/hosts`
+
+.. code::
+
+    192.168.200.18 euwest-rancher-3a905e13.1bef1012-0a93-4a25-8419-ac60363bf3d2.privatelink.westeurope.azmk8s.io
+
+
+- Get the cluster credentials
+
+.. code:: bash
+
+    az aks get-credentials --resource-group euwest-rancher --name euwest-rancher  -f rancher-admin.yaml
+
+
+- Test the connectivity
+
+.. code:: bash
+
+    kubectl --kubeconfig rancher-admin.yaml get nodes
diff --git a/docs/sysadm/support-services/rancher/index.rst b/docs/sysadm/support-services/rancher/index.rst
new file mode 100644
index 0000000000000000000000000000000000000000..c7176df3359d48612c1452eda419769103b8444e
--- /dev/null
+++ b/docs/sysadm/support-services/rancher/index.rst
@@ -0,0 +1,10 @@
+.. _rancher:
+
+Rancher
+=======
+
+.. toctree::
+   :maxdepth: 1
+
+   howtos
+