From 19704e81cc9120697487a1b773ab8c4ff00707ac Mon Sep 17 00:00:00 2001
From: Tamas Gal <tgal@km3net.de>
Date: Tue, 13 Nov 2018 17:29:00 +0100
Subject: [PATCH] Add readme

---
 README.md | 18 +++++++++++++++++-
 1 file changed, 17 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 2b8b187..98122e0 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,18 @@
-# Dockerfiles
+# Dockerfiles for base images used in KM3NeT
+
+This repository contains `Dockerfiles` commonly used as base images for
+KM3NeT software.
+
+The images are automatically built and pushed to the `docker.km3net.de`
+repository under the `base` namespace, which means e.g. the image for
+the `Dockerfile` `base/python:3` can used by using the URL
+`docker.km3net.de/base/python:3`.
+
+To start up container and access a shell within, use the usual `docker`
+commands like:
+
+    docker run -it docker.km3net.de/base/centos:7
+
+It is recommended to use these images in your `~/.gitlab-ci.yml` file for
+continuous integrations instead of the public images from DockerHub.
 
-- 
GitLab