Use Mercurial with Redmine

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 /opt/bitnami/ 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.

Last modification April 8, 2020