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.png "Example output of ccollect")
![ccollect-0.7.1](screenshots/ccollect-0.6-screenshot-20070816.png "Example output of ccollect")
</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 written in simple sh-script, it should run on
any POSIX compatible OS. It is known or reported to run on:

<ul>
   <li>FreeBSD:   amd64/i386
   <li>Linux:     alpha/hppa/ppc/i386
   <li>NetBSD:    alpha/sparc64/i386/amd64
   <li>OpenBSD:   amd64
</ul>
Feel free to send me an e-mail if you've ccollect running on another
OS or architecture.

### Sample configurations
<ul>
   <li><a href="config/ccollect-buche-2006-06-16.tar.bz2">Configuration
   for ccollect 0.4 or later from buche.intern.schottelius.org</a>
   <li><a href="config/ccollect-eiche-2006-02-05.tar.bz2">Configuration
   for ccollect 0.3.3 or earlier from eiche.intern.schottelius.org</a>
</ul>
<h3>Getting ccollect</h3>
<h4>via git</h4>
<pre>
git clone git://git.schottelius.org/cLinux/ccollect.git
or
git clone http://git.schottelius.org/cLinux/ccollect.git
</pre>
Alternatively, you can
<A HREF="http://git.schottelius.org/?p=cLinux/ccollect.git;a=summary">look
at the current status in gitweb</A>.
<!-- ######################################################### -->
<h4>Releases</h4>
<ul>
   <li><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>)
   <li><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>)
<!-- ######################################################### -->
   <li><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>)
      <ul>
         <li>Manpage:
         (<A HREF="ccollect-0.6.2/doc/man/ccollect.text">Text</A>)
         (<A HREF="ccollect-0.6.2/doc/man/ccollect.1">Troff</A>)
         (<A HREF="ccollect-0.6.2/doc/man/ccollect.html">HTML</A>)
         <li>English documentation:
         (<A HREF="ccollect-0.6.2/doc/ccollect.text">Text</A>)
         (<A HREF="ccollect-0.6.2/doc/ccollect.html">HTML</A>)
         (<A HREF="ccollect-0.6.2/doc/ccollect.htm">HTML (docbook)</A>)
         <li>German documentation:
         (<A HREF="ccollect-0.6.2/doc/ccollect-DE.text">Text</A>)
         (<A HREF="ccollect-0.6.2/doc/ccollect-DE.html">HTML</A>)
         (<A HREF="ccollect-0.6.2/doc/ccollect-DE.html">HTML (docbook)</A>)
         (<b>EXTREMLY OUT OF DATE</b>)
      </ul>
<!-- ######################################################### -->
               <li><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>)
      <ul>
         <li>Manpage:
         (<A HREF="ccollect-0.6.1/doc/man/ccollect.text">Text</A>)
         (<A HREF="ccollect-0.6.1/doc/man/ccollect.1">Troff</A>)
         (<A HREF="ccollect-0.6.1/doc/man/ccollect.html">HTML</A>)
         <li>English documentation:
         (<A HREF="ccollect-0.6.1/doc/ccollect.text">Text</A>)
         (<A HREF="ccollect-0.6.1/doc/ccollect.html">HTML</A>)
         (<A HREF="ccollect-0.6.1/doc/ccollect.htm">HTML (docbook)</A>)
         <li>German documentation:
         (<A HREF="ccollect-0.6.1/doc/ccollect-DE.text">Text</A>)
         (<A HREF="ccollect-0.6.1/doc/ccollect-DE.html">HTML</A>)
         (<A HREF="ccollect-0.6.1/doc/ccollect-DE.html">HTML (docbook)</A>)
         (<b>VERY OUT OF DATE</b>)
      </ul>
            <!-- -------------------------------------------------------- -->
   <li><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>)
      <ul>
         <li>Manpage:
         (<A HREF="ccollect-0.6/doc/man/ccollect.text">Text</A>)
         (<A HREF="ccollect-0.6/doc/man/ccollect.1">Troff</A>)
         (<A HREF="ccollect-0.6/doc/man/ccollect.html">HTML</A>)
         <li>English documentation:
         (<A HREF="ccollect-0.6/doc/ccollect.text">Text</A>)
         (<A HREF="ccollect-0.6/doc/ccollect.html">HTML</A>)
         (<A HREF="ccollect-0.6/doc/ccollect.htm">HTML (docbook)</A>)
         <li>German documentation:
         (<A HREF="ccollect-0.6/doc/ccollect-DE.text">Text</A>)
         (<A HREF="ccollect-0.6/doc/ccollect-DE.html">HTML</A>)
         (<A HREF="ccollect-0.6/doc/ccollect-DE.html">HTML (docbook)</A>)
         (<b>VERY OUT OF DATE</b>)
      </ul>
      <!-- -------------------------------------------------------- -->
   <li><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>)
      <ul>
         <li>Manpage:
         (<A HREF="ccollect-0.5.2/doc/man/ccollect.text">Text</A>)
         (<A HREF="ccollect-0.5.2/doc/man/ccollect.man">Troff</A>)
         (<A HREF="ccollect-0.5.2/doc/man/ccollect.html">HTML</A>)
         <li>English documentation:
         (<A HREF="ccollect-0.5.2/doc/ccollect.text">Text</A>)
         (<A HREF="ccollect-0.5.2/doc/ccollect.html">HTML</A>)
         (<A HREF="ccollect-0.5.2/doc/ccollect.texi">Texinfo</A>)
         <li>German documentation:
         (<A HREF="ccollect-0.5.2/doc/ccollect-DE.text">Text</A>)
         (<A HREF="ccollect-0.5.2/doc/ccollect-DE.html">HTML</A>)
         (<A HREF="ccollect-0.5.2/doc/ccollect-DE.texi">Texinfo</A>)
         (<b>OUT OF DATE</b>)
      </ul>
   <!-- -------------------------------------------------------- -->
   <li><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>)
      <ul>
         <li>Manpage:
         (<A HREF="ccollect-0.5.1/doc/man/ccollect.text">Text</A>)
         (<A HREF="ccollect-0.5.1/doc/man/ccollect.man">Troff</A>)
         (<A HREF="ccollect-0.5.1/doc/man/ccollect.html">HTML</A>)
         <li>English documentation:
         (<A HREF="ccollect-0.5.1/doc/ccollect.text">Text</A>)
         (<A HREF="ccollect-0.5.1/doc/ccollect.html">HTML</A>)
         (<A HREF="ccollect-0.5.1/doc/ccollect.texi">Texinfo</A>)
         <li>German documentation:
         (<A HREF="ccollect-0.5.1/doc/ccollect-DE.text">Text</A>)
         (<A HREF="ccollect-0.5.1/doc/ccollect-DE.html">HTML</A>)
         (<A HREF="ccollect-0.5.1/doc/ccollect-DE.texi">Texinfo</A>)
         (<b>OUT OF DATE</b>)
      </ul>
   <!-- -------------------------------------------------------- -->
   <li><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>)
      <ul>
         <li>Manpage:
         (<A HREF="ccollect-0.5/doc/man/ccollect.text">Text</A>)
         (<A HREF="ccollect-0.5/doc/man/ccollect.man">Troff</A>)
         (<A HREF="ccollect-0.5/doc/man/ccollect.html">HTML</A>)
         <li>English documentation:
         (<A HREF="ccollect-0.5/doc/ccollect.text">Text</A>)
         (<A HREF="ccollect-0.5/doc/ccollect.html">HTML</A>)
         (<A HREF="ccollect-0.5/doc/ccollect.texi">Texinfo</A>)
         <li>German documentation:
         (<A HREF="ccollect-0.5/doc/ccollect-DE.text">Text</A>)
         (<A HREF="ccollect-0.5/doc/ccollect-DE.html">HTML</A>)
         (<A HREF="ccollect-0.5/doc/ccollect-DE.texi">Texinfo</A>)
         (<b>OUT OF DATE</b>)
      </ul>
   <!-- -------------------------------------------------------- -->
   <li><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>)
      <ul>
         <li>Manpage:
         (<A HREF="ccollect-0.4.2/doc/man/ccollect.text">Text</A>)
         (<A HREF="ccollect-0.4.2/doc/man/ccollect.man">Troff</A>)
         (<A HREF="ccollect-0.4.2/doc/man/ccollect.html">HTML</A>)
         <li>English documentation:
         (<A HREF="ccollect-0.4.2/doc/ccollect.text">Text</A>)
         (<A HREF="ccollect-0.4.2/doc/ccollect.html">HTML</A>)
         (<A HREF="ccollect-0.4.2/doc/ccollect.texi">Texinfo</A>)
         <li>German documentation:
         (<A HREF="ccollect-0.4.2/doc/ccollect-DE.text">Text</A>)
         (<A HREF="ccollect-0.4.2/doc/ccollect-DE.html">HTML</A>)
         (<A HREF="ccollect-0.4.2/doc/ccollect-DE.texi">Texinfo</A>)
      </ul>
   <!-- -------------------------------------------------------- -->
   <li><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>)
      <ul>
         <li>Manpage:
         (<A HREF="ccollect-0.4.1/doc/man/ccollect.text">Text</A>)
         (<A HREF="ccollect-0.4.1/doc/man/ccollect.man">Troff</A>)
         (<A HREF="ccollect-0.4.1/doc/man/ccollect.html">HTML</A>)
         <li>English documentation:
         (<A HREF="ccollect-0.4.1/doc/ccollect.text">Text</A>)
         (<A HREF="ccollect-0.4.1/doc/ccollect.html">HTML</A>)
         (<A HREF="ccollect-0.4.1/doc/ccollect.texi">Texinfo</A>)
         <li>German documentation:
         (<A HREF="ccollect-0.4.1/doc/ccollect-DE.text">Text</A>)
         (<A HREF="ccollect-0.4.1/doc/ccollect-DE.html">HTML</A>)
         (<A HREF="ccollect-0.4.1/doc/ccollect-DE.texi">Texinfo</A>)
      </ul>
   <!-- -------------------------------------------------------- -->
   <li><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.4/doc/ccollect.html">HTML documentation</A>)
   (<A HREF="ccollect-0.4/doc/ccollect.text">Text documentation</A>)

   <li><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.3/doc/ccollect.html">HTML documentation</A>)
   (<A HREF="ccollect-0.3.3/doc/ccollect.text">Text documentation</A>)

   <li><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.2/doc/ccollect.html">HTML documentation</A>)
   (<A HREF="ccollect-0.3.2/doc/ccollect.text">Text documentation</A>)

   <li><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.1/doc/ccollect.html">HTML documentation</A>)
   (<A HREF="ccollect-0.3.1/doc/ccollect.text">Text documentation</A>)

   <li><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.3/doc/ccollect.html">HTML documentation</A>)
   (<A HREF="ccollect-0.3/doc/ccollect.text">Text documentation</A>)

   <li><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.2/doc/ccollect.html">HTML documentation</A>)
   (<A HREF="ccollect-0.2/doc/ccollect.text">Text documentation</A>)

   <li><A HREF="ccollect-0.1.tar.bz2">ccollect-0.1.tar.bz2</A>
   (<A HREF="ccollect-0.1">browse source</A>)
</ul>
<!-- ######################################################### -->
<h4><A NAME="gentoo">gentoo</A></h4>
<P>ccollect is included into gentoo portage.
Thanks to Ren&eacute; Nussbaumer.
<!-- ######################################################### -->
<h4><A NAME="debian">Debian packages</A></h4>
<P>Marcus Wagner makes ccollect available as Debian packages.
<BR>To get ccollect insert the following line into your /etc/apt/sources.list:
<PRE>
<A HREF="http://deb.notestc.de/clinux/">deb http://deb.notestc.de/ clinux/</A>
</PRE>
<HR>
Daniel Aubry also created a Debian package containing ccollect.
To use his archive, add the following line into your /etc/apt/sources.list:
<PRE>
<A HREF="http://debian.syhosting.ch/software/">deb http://debian.syhosting.ch/ software/</A>
</PRE>
<HR>
<P>
After adding one of the above sources.list entries do
<PRE>apt-get update && apt-get install ccollect</PRE>
<h3><A name="support">Support</a></h3>
<ul>
   <li><a name="ml">Mailing list</a>
   <ul>
      <li>Subscribe: Send an e-mail to
          <b>ccollect-subscribe at lists.schottelius.org</b>
      <li>Sending: Send e-mails to ccollect [at] lists.schottelius.org
      <li>Unsubscribe: Send an e-mail to
          <b>ccollect-unsubscribe at lists.schottelius.org</b>
   </ul>
   <li><a name="irc">IRC</a>
   <ul>
      <li>Join
      <a href="irc://irc.freenode.org/#cLinux">#cLinux on irc.freenode.org</a>
   </ul>
</ul>

<h4><A NAME="links">Related websites</A></h4>
<ul>
   <li><A HREF="http://0xf00.de/ccollect-config.html">ccollect-config</A>,
   a configuration tool written by Frederic Jaeckel
   <li><A HREF="http://www.juame.ch/index.php?go=ccollect">German ccollect
   documentation</A> by Julian Meier
   <li><A HREF="http://muasch.ch/article/show/ccollect-backup-software">German report about
   ccollect by Benedikt K&ouml;ppel, which includes a description of reverse ssh tunnels</a>
</ul>
</BODY>
</HTML>