Tag Archives: git

Setup a Free Git server with Domino Credentials in a few minutes

Today I’m going to show you hav to setup you own internal Free Git server in five minutes

Make sure that you have java version 7 installed in you windows server. JRE or JDK any version works. If you don’t have one goto java.com and install the a java jre.

Goto the java download page scroll down to the bottom of the page and download the JCE


Open up the downloaded zip file and copy the 2 selected files

To the folder lib\security below your java installation folder in my case it was

C:\Program Files\Java\jre7\lib\security you might need to replace existing files nothing to worry about.

This is needed to be able to create the certificates later.

Next step is to  gitblit.com wher your download the Go Git Blit Server for Windows or if you are using Linux or Macosx use that version.


Unzip the zip file in the root to a folder called gitblit or a suitable sub folder, if you change the folder you might need to change url:s in the .cmd files.

Configure GitBlit

We are now going to configure gitblit to use LDAP as authentication method

Open up the file gitblit.properties in the data folder, search for the keyword realm.userService edit this line so the line should look like this realm.userService = com.gitblit.LdapUserService

Setup the connection to the LDAP server

realm.ldap.server=ldap://localhost change the row if your LDAP server isn’t on localhost remember if you want to connect to a domino server and it’s hosted on a windows machine that has AD LDAP on it you need to change the port for the Domino LDAP service.

The syntax if you want to change ip or port is like this ldap://

You also need to change the login user to be able to use the domino LDAP Service

realm.ldap.username = LDAP Manager

realm.ldap.password = your password

To a Domino user and password

Clear the accountBase so it will search all Nodes


Change the accountPattern to

realm.ldap.accountPattern = (&(objectClass=person)(cn=${username}))

Empty the groupBase to search all nodes for groupsrealm.ldap.groupBase =

And the groupMemberPattern to find groups

realm.ldap.groupMemberPattern = (&(objectClass=group)(member=${dn}))

realm.ldap.admins can be edited to add a admin group from LDAP

change the row realm.ldap.email from email to mail

And the row realm.ldap.uid also to mail

Important last step, search the file for localhost and remove that otherwise gitblit will only operate on localhost and you can access it from another machine

Save the file

Generate SSL Certificate

In the Gitblit folder in my case c:\GitBlit there is a cmd file called authority.cmd (if you have another url you might need to modify the file)

start authority.cmd add the information about your certificate

Write the password for your keystore, write gitblit if you don’t want that password you need to edit the gitblit config file so the password match.

The keystore is generated and the cert admin is opened

Close the Window

Start the Git Blit Server using the gitblit.cmd the server will now start in the window.

Your Git server should be up and running now. Let’s access it thru a browser.

Write https://servername or ipadress or localhost and end the adress with :8443

but if you want to use http instead you need to edit the gitblit.properties and change the row

server.httpPort =0 to have the port for the http server i.e. server.httpPort = 8080

The GitBlit interface will load.

Try to login using your Domino credentials

When you have logged in, logout again and login using the standard admin user

username: admin password: admin

and assign yourself as an administrator and change the password of the default admin

Login with your user again

Now your ready to create your first repository

Next step is to connect your git client to the repository. Some clients like sourcetree needs a special setup to accept ssl that is created using a self cert. But that is for the next post.

Setup a Mercurial or Git Source Control server for Windows

Declan Sciolla-Lynch held a session at LS 12 AD102 about how to setup a RedMine Server for Mercurial.

I needed to see if there where a way to setup a Mercuial repository server that could run on windows it could probably run on other operating systems also but I haven’t tested any other.

If found scm-manager a java server that could handle Mercurial, Subversion and Git the best part of this server is that it has a .war file container to you could deploy it in websphere if you have this setup.

But it can also be used with Tomcat and that setup is what I will show you today.

Follow the Notes in 9 video 041 Source Control on how to setup the designer to use the Mercurial plugin.

1. Download  SCM-Manager it’s the scm-webapp-1.12.war that you want to download

2. Download Tomcat 7  click on the appropriate version for your server.

3. Unzip the tomcat zip file to a folder of your choice

4. Open up the Tomcat-users.xml  in the conf subfolder

here you add your admin user add the following rows

in the tomcat users section

This will add a user called admin with the password admin (select your own password)

Save the file

5. Open a commadn prompt goto the bin folder beneath the tomcat folder

Write service install  This will add tomcat to run as a service.

Start the service

6. Open up a webbrowser

The tomcat main page opens up

7. Click on

Scroll down to War file to deploy

8. Select browse and select scm-webapp-1.12.war and deploy

9. Scroll up scm should now be in the list of deployed applications

10. Click on /scm-webapp-1.11 this is now your url to the repository

11. You will now be asked to login to the SCM Manager

Use scmadmin and password scmadmin

12. Click on Repository Types in the Right Navigation beneath Config

13. All the Mercurial fields are blank when you look at them

Click on Start Configuration Wizard to configure them.

in the dialog box select Download and Install

When the configuration is done. Click on Save.

14. You need to restart Tomcat or SCM-Manager to get the Mercurial as an option when creating repositories.

15. Login to SCM-Manager again and create a user

16. Create a repository and select the type a mercurial.

Now You are done, just start to push your code the the repository.
Perhaps there is a way to convert the .war file to a OSGI package so we can drop the Tomcat server.