cdist configuration management Latest manual: Home page:
Go to file
Nico Schottelius 3dfa3be94b cleaned up readme
Signed-off-by: Nico Schottelius <>
2010-10-28 21:32:35 +02:00
bin move around documentation 2010-10-28 21:13:57 +02:00
conf old commit 2010-09-28 20:34:03 +02:00
doc move around documentation 2010-10-28 21:13:57 +02:00
test more stuff to test 2010-09-21 20:27:48 +02:00
Makefile move around documentation 2010-10-28 21:13:57 +02:00
README cleanup readme 2010-10-28 21:23:56 +02:00
TODO cleaned up readme 2010-10-28 21:32:35 +02:00
doc_show_all_exported_variables meaning of variables 2010-09-29 00:14:35 +02:00


## Introduction

cdist configures your system. It is similar to
[cfengine]( and [puppet](
It is inspired by both of those tools:

 * Try to redo the great power you get
 * But leave out the bugs you also got

And cdist is UNIX:

It's designed to
reuse existing tools,
it does not require high level scripting language interpreters
and it is equipped with manpages.

### Architecture

 * KISS (keep it simple and stupid)
  * Allow very easy extension of cdist (creating own types for instance)
 * Push (server pushes configuration) and Pull (client retrieves config) supported
 * User defines configuration in shell scripts using cdist functions
 * Cdist generates internal configuration (cconfig style) and afterwards applies configuration

## Requirements

### Server

 * A posix like shell
 * SSH-Client (for push architecture)
 * SSH-Server (for pull architecture)

### Client

 * A posix like shell
 * SSH-Client (for pull architecture)
 * SSH-Server (for push architecture)

## How to get cdist

    git clone git://

## How to install cdist

    make install

## How to use cdist

    man cdist