diff --git a/hosts b/hosts
new file mode 100644
index 0000000..04900d0
--- /dev/null
+++ b/hosts
@@ -0,0 +1,12 @@
+# hostnames should have the following layout:
+# <environment>-<app>-<domain> ex.
+# development-api.example.com
+#
+# at the moment there is no difference betwen 'development' and or any other environment
+# its purely for the end user's convenience
+
+# i use the dotdee utility to update hosts from a hosts.d file with a symbolic link from /etc/dotdee/etc/hosts.d/60-r3-hosts to this one
+
+127.0.1.1   dev-r3-3ditor.cybafelo.local
+127.0.1.1   dev-r3-portal.cybafelo.local
+127.0.1.1   dev-r3-api.cybafelo.local