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 MacOS) or by clicking the shortcut in the Start Menu under “Start -> Bitnami APPNAME Stack -> Application console” (Windows). On OS X VMs, the installation directory is /opt/bitnami and OS X VM users can click the “Open Terminal” button to run commands. Learn more about the Bitnami stack environment and about OS X VMs.

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/ 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