diff --git a/services/web/README.md b/services/web/README.md
new file mode 100644
index 000000000..f4b624871
--- /dev/null
+++ b/services/web/README.md
@@ -0,0 +1,8 @@
+# Web service
+
+The web service embeds and serves the static files of the [Infinite Scale Web Client](https://github.com/owncloud/web).  
+It also provides a minimal API for branding functionality like changing the logo.
+
+# Custom compiled Web assets
+
+If you want to use your custom compiled web assets then you can do that by setting the `WEB_ASSET_PATH` variable to point to your compiled files.