diff --git a/README.md b/README.md
index 15eb047..cf4756d 100644
--- a/README.md
+++ b/README.md
@@ -1,14 +1,34 @@
-# Odoo IoT Bock in Docker
+# Odoo Pos Distribution
 
-Dockerfiles and Docker Compose configuration for running Odoo IoT Box in Docker.
+Dockerfiles, Docker Compose and Kubernetes configuration for running an Odoo based PoS
+in container and Kubernets.
 
 Additionally it contains  [pos-addons](https://github.com/it-projects-llc/pos-addons)
 for using receipt printers over the network.
 
 ## Quickstart
 
+### Docker Compose
+
 1. `docker-compose up`
+
+Continue with "Odoo PoS configuration"
+
+### Kubernetes / K3s
+
+The provided YAML files have been developed and tested with [k3s](https://k3s.io/).
+Installation will happen in the namespace `pos`.
+
+1. Install [k3s](https://k3s.io/) (any other Kubernetes should work as well)
+1. Install [local-path-provisioner](https://github.com/rancher/local-path-provisioner)
+1. Apply the deployment YAMLs: `kubectl apply -f deployment/`
+
+Continue with "Odoo PoS configuration"
+
+## Odoo PoS configuration
+
 1. Connect to Odoo and create a new database
+   On Kubernetes the Ingress defines the hostnames `pos` and `iotbox`
 1. Install Odoo Apps:
   * "Point of Sale"
   * "POS Network Printer"
@@ -16,6 +36,14 @@ for using receipt printers over the network.
 1. Configure PoS for IoT Box (see docs/iotbox-config.png)
 1. Configure Order Printer (see docs/orderprinter.png)
 
+## Hardware and Networking
+
+* Default network assumed: `192.168.233.0/24`
+* Printers: 192.168.233.3 and 192.168.233.5
+* Printers used in this project: [Epson TM-T20II](https://www.epson.ch/products/sd/pos-printer/epson-tm-t20ii)
+
+More hardware description and a network diagram: tbd.
+
 ## Backup configuration
 
 Example contents of `backup.env`: