SCM Creator 2.3.5

SCM Creator user documentation

Task-oriented guidance for installing the plugin, creating repositories, connecting remote providers, and browsing source code in Redmine 6.

Choose a guide

Start with deployment and Redmine settings, or go directly to the repository provider your project uses.

Version note: this guide documents SCM Creator 2.3.5. The public download section currently retains the tested 2.3.4 archive until a 2.3.5 package is published; the 2.3.5 code change only improves VCSAdmin error logging and adds no migration.

Install and enable

Install SCM Creator, run migrations, configure provider roots, and enable the required SCM types.

Read getting started

Local repositories

Create managed Git, Subversion, Mercurial, or Bazaar repositories from project settings.

Configure local SCM

GitHub.com mirrors

Set up GitHub.com

VCSAdmin Git

Connect one read-only VCSAdmin API repository without creating a clone or mirror on the Redmine server.

Connect VCSAdmin Git

Choose the right provider

Local SCM

Location: Redmine server filesystem

Choose it when: Redmine should create and manage Git, Subversion, Mercurial, or Bazaar storage.

Limitation: Publishing over HTTP, SSH, or DAV must be configured separately.

GitHub.com

Location: GitHub.com plus a local bare mirror

Choose it when: The remote repository lives on GitHub.com but Redmine needs normal local Git browsing.

Limitation: Mirror creation and refresh run synchronously.

VCSAdmin Git

Location: Remote VCSAdmin server only

Choose it when: Redmine should browse through the read-only API without storing a repository copy.

Limitation: No write operations, blame, archives, statistics, or binary download.

Repository administration in Redmine

SCM Creator integrates into the standard project creation and repository settings screens. The examples below show the project-level creation options and the complete form for a managed local Git repository.

SCM Creator repository options in the Redmine project creation form — Project setupEnable the Repository module and create a repository with the project.

SCM Creator form for creating a managed local Git repository in Redmine — Repository settingsChoose Git, confirm the protected path and create the local repository.

Something does not work?

Use the error-oriented guide for missing providers, permission problems, connection failures, synchronization limits, and safe deletion behavior.

Troubleshooting & FAQ