www.nico.schottelius.org/software/ccollect.mdwn

## ccollect - (pseudo) incremental backup with different exclude lists using hardlinks and rsync

<P ALIGN="center">
<a href="screenshots/">
![ccollect-0.7.1](screenshots/ccollect-0.7.1-screenshot-20090527.png "Example output of ccollect-0.6")
</a>
<P>ccollect backups data from local and remote hosts to your local harddisk.
Although ccollect creates full backups, it requires very less space on the
backup medium, because ccollect uses hardlinks to create an initial copy of
the last backup. Only the inodes used by the hardlinks and the changed files
need additional space.

ccollect uses [rsync](http://www.samba.org/rsync/) for synchronisation.
Since ccollect-0.2 there is [asciidoc](http://www.methods.co.nz/asciidoc/)
based documentation included in the distribution (see below).
You should also be able to configure ccollect with the help of the example
configuration in conf/.

## Documentation

You can read

 * the ccollect handbook as
   <a href="doc/ccollect.text">text</a>,
   <a href="doc/ccollect.html">HTML</a>,
   <a href="doc/ccollect.htm">HTML (docbook)</a>,
 * the ccollect manpage as 
   <a href="doc/man/ccollect.text">text</a>,
   <a href="doc/man/ccollect.1">troff</a>
   <a href="doc/man/ccollect.html">HTML</a>
   <a href="doc/man/ccollect.htm">HTML (docbook)</a>
 * or view some <a href="screenshots/">screenshots</a>.

There used to be a German translation of the handbook, but it
is outdated and thus removed.

## Portability
As ccollect is a simple shell script, it should run on
any POSIX compatible OS. It is known or reported to run on:

 * FreeBSD:   amd64/i386
 * Linux:     alpha/hppa/ppc/i386
 * NetBSD:    alpha/sparc64/i386/amd64
 * OpenBSD:   amd64

Feel free to send an e-mail if you are running ccollect on
another OS or architecture.

For more information regarding portability have a look at the [[u2u|net/u2u]] idea.

## Sample configurations
 * <a href="config/ccollect-buche-2006-06-16.tar.bz2">Configuration
   for ccollect 0.4 or later from buche.intern.schottelius.org</a>
 * <a href="config/ccollect-eiche-2006-02-05.tar.bz2">Configuration
   for ccollect 0.3.3 or earlier from eiche.intern.schottelius.org</a>

## Getting ccollect

### Development versions
You can get the latest (development) version via git:

    git clone git://git.schottelius.org/cLinux/ccollect.git

Additionally, the following other git ressources are available:

 * [Gitweb](http://git.schottelius.org/?p=cLinux/ccollect.git;a=summary).
 * [Mirror at github](http://github.com/telmich/ccollect/tree/master)
<!-- * [John's tree](http://github.com/jll2/ccollect/) -->


### Releases
 * <A HREF="ccollect-0.7.1.tar.bz2">ccollect-0.7.1.tar.bz2</A>
   (<A HREF="ccollect-0.7.1">browse source</A>)
   (<A HREF="ccollect-0.7.1/doc/changes/0.7.1">Changes</A>)
   <!-- -------------------------------------------------------- -->
 * <A HREF="ccollect-0.7.0.tar.bz2">ccollect-0.7.0.tar.bz2</A>
   (<A HREF="ccollect-0.7.0">browse source</A>)
   (<A HREF="ccollect-0.7.0/doc/CHANGES">Changes</A>)
   <!-- -------------------------------------------------------- -->
 * <A HREF="ccollect-0.6.2.tar.bz2">ccollect-0.6.2.tar.bz2</A>
   (<A HREF="ccollect-0.6.2">browse source</A>)
   (<A HREF="ccollect-0.6.2/doc/CHANGES">Changes</A>)
   <!-- -------------------------------------------------------- -->
 * <A HREF="ccollect-0.6.1.tar.bz2">ccollect-0.6.1.tar.bz2</A>
   (<A HREF="ccollect-0.6.1">browse source</A>)
   (<A HREF="ccollect-0.6.1/doc/CHANGES">Changes</A>)
   <!-- -------------------------------------------------------- -->
 * <A HREF="ccollect-0.6.tar.bz2">ccollect-0.6.tar.bz2</A>
   (<A HREF="ccollect-0.6">browse source</A>)
   (<A HREF="ccollect-0.6/doc/CHANGES">Changes</A>)
   <!-- -------------------------------------------------------- -->
 * <A HREF="ccollect-0.5.2.tar.bz2">ccollect-0.5.2.tar.bz2</A>
   (<A HREF="ccollect-0.5.2">browse source</A>)
   (<A HREF="ccollect-0.5.2/doc/CHANGES">Changes</A>)
   <!-- -------------------------------------------------------- -->
 * <A HREF="ccollect-0.5.1.tar.bz2">ccollect-0.5.1.tar.bz2</A>
   (<A HREF="ccollect-0.5.1">browse source</A>)
   (<A HREF="ccollect-0.5.1/doc/CHANGES">Changes</A>)
   <!-- -------------------------------------------------------- -->
 * <A HREF="ccollect-0.5.tar.bz2">ccollect-0.5.tar.bz2</A>
   (<A HREF="ccollect-0.5">browse source</A>)
   (<A HREF="ccollect-0.5/doc/CHANGES">Changes</A>)
   <!-- -------------------------------------------------------- -->
 * <A HREF="ccollect-0.4.2.tar.bz2">ccollect-0.4.2.tar.bz2</A>
   (<A HREF="ccollect-0.4.2">browse source</A>)
   (<A HREF="ccollect-0.4.2/doc/CHANGES">Changes</A>)
   <!-- -------------------------------------------------------- -->
 * <A HREF="ccollect-0.4.1.tar.bz2">ccollect-0.4.1.tar.bz2</A>
   (<A HREF="ccollect-0.4.1">browse source</A>)
   (<A HREF="ccollect-0.4.1/doc/CHANGES">Changes</A>)
   <!-- -------------------------------------------------------- -->
 * <A HREF="ccollect-0.4.tar.bz2">ccollect-0.4.tar.bz2</A>
   (<A HREF="ccollect-0.4">browse source</A>)
   (<A HREF="ccollect-0.4/doc/CHANGES">Changes</A>)
   <!-- -------------------------------------------------------- -->
 * <A HREF="ccollect-0.3.3.tar.bz2">ccollect-0.3.3.tar.bz2</A>
   (<A HREF="ccollect-0.3.3">browse source</A>)
   (<A HREF="ccollect-0.3.3/doc/CHANGES">Changes</A>)
   <!-- -------------------------------------------------------- -->
 * <A HREF="ccollect-0.3.2.tar.bz2">ccollect-0.3.2.tar.bz2</A>
   (<A HREF="ccollect-0.3.2">browse source</A>)
   (<A HREF="ccollect-0.3.2/doc/CHANGES">Changes</A>)
   <!-- -------------------------------------------------------- -->
 * <A HREF="ccollect-0.3.1.tar.bz2">ccollect-0.3.1.tar.bz2</A>
   (<A HREF="ccollect-0.3.1">browse source</A>)
   (<A HREF="ccollect-0.3.1/doc/CHANGES">Changes</A>)
   <!-- -------------------------------------------------------- -->
 * <A HREF="ccollect-0.3.tar.bz2">ccollect-0.3.tar.bz2</A>
   (<A HREF="ccollect-0.3">browse source</A>)
   (<A HREF="ccollect-0.3/doc/CHANGES">Changes</A>)
   <!-- -------------------------------------------------------- -->
 * <A HREF="ccollect-0.2.tar.bz2">ccollect-0.2.tar.bz2</A>
   (<A HREF="ccollect-0.2">browse source</A>)
   (<A HREF="ccollect-0.2/doc/CHANGES">Changes</A>)
   <!-- -------------------------------------------------------- -->
 * <A HREF="ccollect-0.1.tar.bz2">ccollect-0.1.tar.bz2</A>
   (<A HREF="ccollect-0.1">browse source</A>)

#### Gentoo
<P>ccollect is included into gentoo portage. Thanks to Ren&eacute; Nussbaumer.

### Debian
<P>Marcus Wagner makes ccollect available as Debian packages.
<BR>To get ccollect insert the following line into your /etc/apt/sources.list:
    <A HREF="http://deb.notestc.de/clinux/">deb http://deb.notestc.de/ clinux/</A>
<HR>
Daniel Aubry also created a Debian package containing ccollect.
To use his archive, add the following line into your /etc/apt/sources.list:
    <A HREF="http://debian.syhosting.ch/software/">deb http://debian.syhosting.ch/ software/</A>

After adding one of the above sources.list entries do

    apt-get update && apt-get install ccollect

## Support
 * There is a general
 [ccollect mailing list](http://l.schottelius.org/mailman/listinfo/ccollect)
 available.
 * You can join the development ***IRC channel***
   [#cLinux on irc.freenode.org](irc://irc.freenode.org/#cLinux).

## Related websites
 * <A HREF="http://0xf00.de/ccollect-config.html">ccollect-config</A>,
   a configuration tool written by Frederic Jaeckel
 * [German report about ccollect including a description
   of reverse ssh tunnels](http://muasch.ch/article/show/ccollect-backup-software)
   by Benedikt K&ouml;ppel,

[[!tag unix backup]]