cadvisor/docs/web.md
Rohit Jnagal e83f7f3802 Update web.md
Closes #591
2015-03-15 18:34:09 -07:00

30 lines
1.3 KiB
Markdown

# cAdvisor Web UI
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, in case you decide to use both files in the arguments only HTTP basic auth will be enabled.