diff --git a/Dockerfile b/Dockerfile
new file mode 100644
index 0000000..9e95e40
--- /dev/null
+++ b/Dockerfile
@@ -0,0 +1,7 @@
+FROM python:3.6.3-slim
+
+WORKDIR /usr/src/app
+
+RUN pip install --no-cache-dir -v pandas==0.20.3
+
+CMD [ "python" ]
diff --git a/README.md b/README.md
index e59ec24..244eb78 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,21 @@
-# pandas-docker
-pandas is an open source library providing data analysis tools for the Python programming language. This docker image contains pandas 0.20.3 and is build on top of the official python 3.6.3 slim image.
+# Docker container for Pandas
+
+[pandas](http://pandas.pydata.org/) is an open source library providing data analysis tools for the Python programming language. This docker image contains pandas 0.20.3 and is build on top of the official python 3.6.3 slim image.
+
+* [GitHub Repository with Dockerbuild files](https://github.com/felixlohmeier/pandas-docker)
+* [Docker Hub with docker images](https://hub.docker.com/r/felixlohmeier/pandas/)
+
+## fixed versions
+
+* Python 3.6.3
+* Pandas 0.20.3
+
+## usage
+
+### python console
+
+> docker run -it --rm felixlohmeier/pandas
+
+### run a script
+
+> docker run -it --rm --name my-script -v "$PWD":/usr/src/pandas:z -w /usr/src/pandas felixlohmeier/pandas python my-script.py
\ No newline at end of file