The Web Dashboard is configured through the dashboard.config file, a set of XSL Files, and a set of style sheets (CSS files). In most cases this file will be found in the root of the Web Dashboard application. The only deployment-specific configuration in the web.config file is an optional appSetting which can specify an alternative location for the dashboard.config file. If you want to use this behaviour, set the DashboardConfigLocation appSetting value to be the absolute path of your dashboard.config file.

The configuration file forms a tree of constructs, starting at the root element. The documentation for the rest of this section is reference documentation for each of the types of constructs you can use.

Default Configuration The dashboard.config file that ships with CruiseControl.NET will work with a default setup, i.e. one where you are using a build server on the same machine as the Web Dashboard and haven't changed any of the Remoting settings. From CCNet 1.5 onwards, the WebDashboard Admin plugin is standard loaded, and the rest of dashboard.config file is as good as empty. On installation you must edit the dashboard.config once to set the password that will be used for this plugin.

Language Configuration you can force the dashboard language via the appsettings section in Web.config <add key="language" value="en-US" /> to force the english language.

Be sure that the dashboard.config file is editable by the IIS-user when you use the WebDashboard Admin plugin

Monitoring Multiple Servers It's easy to use a single IIS running the Web Dashboard to monitor multiple CruiseControl.Net build servers. See the Servers Configuration Block.

Configuration elements

• Dashboard Configuration Block
  • Plugins Configuration Block
    • Build Log Build Plugin
    • Build Report Build Plugin
    • CCTray Download Plugin
    • Custom templates
    • Dashboard Administration Plugin
    • Farm Report Farm Plugin
    • HTML Report Plugin
    • Latest Build Report Project Plugin
    • modificationHistoryProjectPlugin
    • Multiple XSL Report Build Plugin
    • Ohloh Project Plugin
    • Project Configurable Build Plugin
    • Project Configuration Server Plugin
    • Project Report Project Plugin
    • Project Statistics Plugin
    • Project Status Plugin
    • Project Timeline Plugin
    • Queue Status Server Plugin
    • RSSFeedProjectPlugin
    • Server Audit History Project Plugin
    • Server Audit History Server Plugin
    • Server Information Server Plugin
    • Server Log Project Plugin
    • Server Log Server Plugin
    • Server Report Server Plugin
    • Server Security Configuration Project Plugin
    • Server Security Configuration Server Plugin
    • Simple Security Plugin
    • User List Project Plugin
    • User List Server Plugin
    • View All Builds Project Plugin
    • View Configuration Project Plugin
    • ViewServerQueue Server Plugin
    • XSL Report Build Plugin
    • XSL Report Project Plugin
  • Remote Services Configuration Block
    • Servers Configuration Block

Upgrading from previous versions There is no longer any project-specific configuration required to use the Web Dashboard. However, you should set the webURL element properly in your project's Build Server configuration to make sure CCTray and Email publishing work.