From KitwarePublic
Revision as of 14:01, 30 August 2017 by Zack (talk | contribs)
Jump to navigationJump to search

< CDash Main Page

CDash is a LAMP application, running on Apache using PHP to access a MySQL or PostgreSQL database.

System Requirements

CDash requires:

  • A web server (Apache, NGINX, IIS) with PHP (5.5.9+) and SSL enabled.
  • Access to a MySQL (5.x+) or PostgreSQL (8.3+) database server.

PHP needs to have the following modules enabled:

  • cURL (for site statistics)
  • GD (for regression tests)
  • mbstring
  • pdo-mysql or pdo-postgresql
  • XSL

Downloading CDash

Stable Release

The current stable release of CDash is 2.4.0 you can either download it as a zip archive

 git clone
 git checkout v2.4.0-prebuilt

Previous versions of CDash

GIT Development version

CDash uses composer and npm to manage its 3rd party dependencies.

We provide two developments branches, master and prebuilt. If you're working with the master branch, then you have to run composer & npm yourself. The prebuilt branch has these dependencies already downloaded for you.


Use the master branch if you'd like to modify CDash or contribute to its development.

git clone CDash
git checkout master
curl -sS | php 
php composer.phar install
npm install


The prebuilt branch is a good choice if you'd like to use new features in CDash on a production server.

git clone CDash
git checkout prebuilt

Configuring CDash

Create CDash/config/config.local.php and specify the following database settings.

   // Hostname of the database server or name of unix socket
   $CDASH_DB_HOST = 'localhost';
   // Login for database access
   $CDASH_DB_LOGIN = 'root';
   // Port for the database (leave empty to use default)
   // Password for database access
   // Name of the database
   $CDASH_DB_NAME = 'cdash';
   // Database type
   $CDASH_DB_TYPE = 'mysql';
   // Must be one of host, unix_socket

This allows CDash to connect to your database server.

CDash can create a new database for you if you are using MySQL. For Postgres, you have to create the new database yourself.

See CDash:Configuration for information about more configuration options.

Installing CDash

Only CDash's public subdirectory should be exposed to the web. There are two main ways to accomplish this:

  1. Create a symbolic link from DocumentRoot to CDash/public.
  2. Configure DocumentRoot to point directly to CDash/public.

See Repository Reorganization Aftermath for more details and information.


The web server user needs to have write access to the following directories:

  • CDash/backup
  • CDash/log
  • CDash/public/rss
  • CDash/public/upload