server-tools is an open source project powered by Assembla

Assembla offers free public and private SVN/Git repositories and project hosting with bug/issue tracking and collaboration tools.

  • Public clone URL:
  • Use this URL in your Git client.

Getting started with Git

1. Installing a Git client

You need to download and install a Git client before you can start using Git on your local computer.
  • Mac OS X
  • Download and run git-osx-installer.

    Or install from sources. Install Xcode tools from OSX DVD, then use HomeBrew to install git:

    ruby -e "$(curl -fsSL"
    brew install git
  • Debian-Ubuntu
  • apt-get install git-core
  • Windows
  • Download msysgit installation and follow the steps.

  • BSD
  • cd /usr/ports/devel/git
    make install

2. Set up your email in Git

Add your name and your email in your Git user settings. Your username will appear on commits, stream and ticket comments generated from commits. Make sure that the email you set up in git matches the email saved in your Assembla profile.
git config --global "Anonymous" # Set your name
git config --global "test@example.tld" # Set an email

git config --global # Verify
# test@example.tld
git config --global # Verify
# Anonymous

3. Generate and upload your SSH key

  1. Generating a new key:

    • From the command prompt in Windows or Terminal in Mac OS and Linux run this command:
      ssh-keygen -t rsa -C "test@example.tld"

      Note: This email should match the email you set up in the previous step

    • You will be prompted to give the key a filename. You can accept the default name by just hitting Enter.
    • You will be asked for passphrase, you usually don't need one too, you can skip this by hitting Enter.
  2. Copy public key ( into your Assembla Profile:

    • In Windows, the key pair will appear at C:\Users ame\.ssh by default. In Mac and Linux, it will be in ~/.ssh hidden directory.
    • Open the public key file (the default name is in a text editor, such as Notepad in windows, and select all and copy (Ctrl + A followed by Ctrl + C).
    • Log in to your Assembla account. Go to Profile -> Manage SSH keys and add the key.


1. How to update tickets from commit comments

You can use commit comments to link your changesets to Assembla tickets, and add comments to tickets or change their status.

Use "re #4" to link your commit to ticket #4.

Also, "references", "refs" and "see" will add a comment to the target ticket.

Use "<status> #4" to set ticket #4 to the target status. For example, "Test #4" or "Fixed #4".

Use "<status> #tickets" or "re #tickets" to reference all affected tickets in merge request.

2. Can I use HTTP/HTTPS instead of SSH?

Yes, you can connect to your repository using http/https. The https url for the repo can be copied by clicking https button next to the repo URL on the source tab.

About Git

Git is a popular version control system designed to handle very large projects with speed and efficiency; it is used mainly for various open source projects, most notably the Linux kernel. Git falls in the category of distributed source code management tools, similar to e.g. GNU Arch or Monotone (or BitKeeper in the proprietary world). Every Git working directory is a full-fledged repository with full revision tracking capabilities, not dependent on network access or a central server.