cdist/REAL_README

## Introduction

cdist configures your system. It is similar to
[cfengine](http://www.cfengine.org/) and [puppet](http://www.puppetlabs.com/).
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
 * 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://git.schottelius.org/cdist

## How to install cdist

    make install

## How to use cdist

    man cdist

## Support

### IRC

You can join the development ***IRC channel***
[#cLinux on irc.freenode.org](irc://irc.freenode.org/#cLinux).

### Mailing list

Bug reports, questions, patches, etc. should be send to the
[cdist mailing list](http://l.schottelius.org/mailman/listinfo/cdist).