diff --git a/docs/web.md b/docs/web.md
index 16a1d2b0..7197165f 100644
--- a/docs/web.md
+++ b/docs/web.md
@@ -5,3 +5,25 @@ cAdvisor exposes a web UI at its port:
 `http://<hostname>:<port>/`
 
 This UI has one primary resource at `/containers` which exports live information about all containers on the machine.
+
+## Web UI authentication
+
+You can add authentication to the web UI by either HTTP basic or HTTP digest authentication. 
+
+### HTTP basic authentication
+
+You will need to add a *http_auth_file* parameter with a HTTP basic auth file generated using htpasswd to enable HTTP basic auth. By default the auth realm is set as localhost.
+
+`./cadvisor --http_auth_file test.htpasswd --http_auth_realm localhost`
+
+The [test.htpasswd](../test.htpasswd) file provided has a username and password already added (admin:password1) for testing purposes.
+
+### HTTP Digest authentication
+
+You will need to add a *http_digest_file* parameter with a HTTP digest auth file generated using htdigest to enable HTTP Digest auth. By default the auth realm is set as localhost.
+
+`./cadvisor --http_digest_file test.htdigest --http_digest_realm localhost`
+
+The [test.htdigest](../test.htdigest) file provided has a username and password already added (admin:password1) for testing purposes.
+
+**Note** : You can use either type of authentication, incase you decide to use both files in the arguments only HTTP basic auth will be enabled.