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:

          $ sudo apt-get 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 May 10, 2022