rkt · philips · Mar 13, 2017 · Mar 3, 2017 · lucab · Mar 6, 2017
diff --git a/Documentation/integrations.md b/Documentation/integrations.md
@@ -0,0 +1,19 @@
+# Integrations
+This document tracks projects that integrate with rkt. [Join the community](https://github.com/coreos/rkt/), and help us keep the list up-to-date.
+
+## Projects 
+[Kubernetes](https://kubernetes.io/docs/getting-started-guides/rkt/): a enterprise grade container orchestration solution. Kubernetes offers rkt support as an alternative to the standard install.
+
+[Nomad](https://www.nomadproject.io/docs/drivers/rkt.html): a container orchestration platform focused on ease of use. Nomad supports rkt through the rkt driver.
+
+[dgr](https://github.com/blablacar/dgr): a container build and runtime tool, preferring convention over configuration.
+
+[Mulled](https://github.com/BioContainers/mulled): a tool for generating minimal container images.
+
+[Quay.io](https://quay.io/): an enterprise ready container registry. Quay hosts rkt images.
+
+[SELinux](https://coreos.com/rkt/docs/latest/selinux.html): an access control and security toolkit for containers.
+
+[Linux](https://coreos.com/rkt/docs/latest/distributions.html): an open an extensible OS. rkt is included in the package managers on Red Hat, Ubuntu, and many other popular Linux distributions.
+
+[cAdvisor](https://github.com/google/cadvisor): a daemon that monitors resource usage and performance for running containers.
diff --git a/Documentation/production-users.md b/Documentation/production-users.md
@@ -0,0 +1,12 @@
+# Production users
+
+This document tracks people and use cases for rkt in production. [Join the community](https://github.com/coreos/rkt/), and help us keep the list up-to-date.
+
+## [BlaBlaCar](https://www.blablacar.com/)
+BlaBlaCar is a trusted car-pooling service based in France. They've [blogged about](http://blablatech.com/blog/why-and-how-blablacar-went-full-containers) the stability of rkt being a big appeal.
+
+## [Kumul.us](https://kumul.us/)
+Kumulus Technologies offers classes and services to optimize your Cloud. They've [blogged about](https://kumul.us/docker-youve-failed-me-again-rkt-please-save-me/) rkt's pod native features and Kubernetes support being a reason for their adoption.
+
+## [Kinvolk.io](https://kinvolk.io/)
+Kinvolk are a professional consulting team and active contributors to systemd, rkt, and the Linux kernel. rkt helps them easily [test various Linux kernels and configurations](https://kinvolk.io/blog/2017/02/using-custom-rkt-stage1-images-to-test-against-various-kernel-versions/).
diff --git a/README.md b/README.md
@@ -90,3 +90,10 @@ Due to a bug in the Linux kernel, using rkt when `/var/lib/rkt` is on btrfs requ
 Due to a bug in the Linux kernel, using rkt's overlay support in conjunction with SELinux requires a set of patches that are only currently available on some Linux distributions (for example, [CoreOS Linux](https://github.com/coreos/coreos-overlay/tree/master/sys-kernel/coreos-sources/files)). Work is ongoing to merge this work into the mainline Linux kernel ([#1727](https://github.com/coreos/rkt/issues/1727#issuecomment-173203129)).
 
 Linux 3.18+ is required to successfully garbage collect rkt pods when system services such as udevd are in a slave mount namespace (see [lazy umounts on unlinked files and directories](https://github.com/torvalds/linux/commit/8ed936b) and [#1922](https://github.com/coreos/rkt/issues/1922)).
+
+## Related Links
+
+### Integrations and Production Users
+
+- [Projects integrating with rkt](https://github.com/coreos/rkt/blob/master/Documentation/integrations.md)
+- [Production users](https://github.com/coreos/rkt/blob/master/Documentation/production-users.md)