diff --git a/README.md b/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..7d842a30ddb2f6632adc1c166157eecb33ac7fa3
--- /dev/null
+++ b/README.md
@@ -0,0 +1,20 @@
+# A Complete Panda Gazebo Workspace
+
+## Requirements
+
+- Ubuntu 18.4
+- ROS Melodic
+
+## Installation
+
+- clone the repo `git clone --recurse-submodules git@git-st.inf.tu-dresden.de:ceti/ros/panda_gazebo_workspace.git`
+- install ROS package dependencies `rosdep install --from-paths .`
+- build the workspace `catkin build`
+- source the config: depending on your shell
+    - `source devel/setup.bash` (default)
+    - `source devel/setup.sh`
+    - `source devel/setup.zsh`
+- run the simulation `roslaunch panda_simulation simulation.launch`
+
+
+