Backup tool that enhances the trac-admin hotcopy utility


This plugin is a script that provides some additional functionality around TracAdmin's hotcopy function. The script supports archiving the backup in gzip, bzip2 or zip format and can be configured to retain a specified number of past backups. Ideal for use as a cron job.

The script is derived from the '' script included in the Subversion distribution, which provides similar functionality around Subversion's hotcopy utility.


Create a backup of the project at PROJECT_PATH in a subdirectory of
the BACKUP_PATH location, named with the backup date and time.

  --archive-type=FMT Create an archive of the backup. FMT can be one of:
                       bz2 : Creates a bzip2 compressed tar file.
                       gz  : Creates a gzip compressed tar file.
                       zip : Creates a compressed zip file.
  --num-backups=N    Number of prior backups to keep around (0 to keep all).
  --help      -h     Print this help message and exit.


  1. Back up the project at /var/trac/myproj to /nfs/backup/trac/myproj-YYYY-mm-dd-HHMM: /var/trac/myproj /nfs/backup/trac
  1. Back up the project at /var/trac/myproj to /nfs/backup/trac/myproj-YYYY-mm-dd-HHMM.tar.gz and delete all but the 7 most recent backups, including the one just created: --archive-type=gz --num-backups=7 /var/trac/myproj /nfs/backup/trac

Bugs/Feature Requests

Existing bugs and feature requests for TracHotBackupScript are here.

If you have any issues, create a new ticket.


Download the zipped source from here, or fetch the script itself here.


You can check out TracHotBackupScript from here using Subversion, or browse the source with Trac.


General instructions on installing Trac plugins can be found on the TracPlugins page.

Recent Changes

16744 by rjollos on 2017-08-24 01:09:05
Remove hard-code path to trac-admin

Patch by Jun Omae.

16743 by rjollos on 2017-08-23 17:00:42
Fix unable to specify archive type

Patch by Jun Omae.

16742 by rjollos on 2017-08-22 20:26:41
Reformat using autopep8


Author: kcalcagno
Maintainer: Kevin Calcagno

Last modified 7 months ago Last modified on Aug 12, 2017, 7:44:06 AM