How to Install SCM Manager on macOS

SCM Manager is a web-based application for managing your source code repositories, it provides an easy and intuitive web interface for Git, Mercurial, and Subversion. This tutorial will guide you through the steps of installing SCM Manager on your macOS system.

Prerequisites

To complete this tutorial, you will need:

A macOS system with administrative privileges
Java Development Kit (JDK) 8 or higher

Step 1: Download SCM Manager

The first step is to download the latest version of SCM Manager from the official website. You can download it using the following command:

curl -L -O https://maven.scm-manager.org/nexus/content/repositories/releases/sonia/scm/scm-server/2.31.1/scm-server-2.31.1-app.tar.gz

Step 2: Extract the tar file

After downloading the tar file, extract it to your desired destination:

tar -xzvf scm-server-2.31.1-app.tar.gz

Step 3: Configure SCM Manager

Before running SCM Manager, you need to configure a few settings.

Configure the hostname

By default, SCM Manager listens only on the loopback network interface, if you want to enable external access, you have to configure it in the config/config.xml file. Edit this file and set the baseUrl to http://yourhostname:8080/scm:

<baseUrl>http://yourhostname:8080/scm</baseUrl>

Configure the HTTP(S) Port

You can also configure the port on which SCM Manager listens by editing the config/config.xml file. Look for the following section:

<http>
  <port>8080</port>
  <enabled>true</enabled>
  <!-- ... -->
</http>

Change the value of the port parameter to a different port number if desired.

Configure Users

You need to create a user with administrative rights to access SCM Manager. Open the config/users.xml file and add the following user to the users list:

<user>
  <username>admin</username>
  <password>password</password>
  <displayName>Administrator</displayName>
  <mail>[email protected]</mail>
  <type>xml</type>
  <permissions>*</permissions>
</user>

Change the password and email address as required.

Step 4: Starting SCM Manager

Start SCM Manager with the following command from the root directory of the extracted archive:

./bin/scm-server start

You should see a message like:

[2018-01-17 13:33:02] [INFO ]: SCM Server running on http://localhost:8080/scm/

Open your web browser and navigate to the URL specified in the output message. You should see the login page, enter the credentials of the administrative user you created in the previous step.

Congratulations! You have successfully installed SCM Manager on your macOS system. You can now use it to manage your source code repositories.