nativeInstallerredmine

Use Mercurial with Redmine

Before running the commands shown on this page, you should load the Bitnami stack environment by executing the installdir/use_APPNAME script (Linux and Mac OS X) or by clicking the shortcut in the Start Menu under “Start -> Bitnami APPNAME Stack -> Application console” (Windows). Learn more.

Redmine only works with Mercurial repositories cloned in your local machine, as explained in the official guide.

  • Install the Mercurial package:

    • Debian:

      $ sudo apt-get install mercurial
      
    • CentOS:

      $ sudo yum install mercurial
      
  • Restart services:

    $ sudo installdir/ctlscript.sh restart
    
  • Create the repository directory, clone it and give it the proper permissions:

    $ cd $HOME
    $ mkdir mercurialRepo
    $ cd mercurialRepo
    $ sudo hg clone REPO_URL
    
  • Add your repository to Redmine by navigating in your project to the “Settings -> Repositories -> New repository” menu. Replace the ID placeholder with a short identifier for the repository, the USER placeholder with the username, and the REPO placeholder with the correct directory name for the cloned repository.

    SCM: Mercurial
    Identifier: ID
    Path to repository: /home/USER/mercurialRepo/REPO
    
  • Check the repository and confirm that you can view the files, commits, comments and so on.