Aalto IT Help

View content in another language: suomi

Aalto Version: Quick guide

Centrally managed version control system is available for all Aalto users at https://version.aalto.fi

Info & Login to the system

Aalto users are able to login to the system with Haka authentication (Picture 1). External users with HAKA account can also use the same method to access the system. External users with locally configured credentials will have to type their credentials to the dedicated fields. Within the Standard tab (Picture 2).


Picture 1: Use Aalto / HAKA login to access version.aalto.fi with Aalto credentials


Picture 2: External user login

Creating a new project

After a successful login, new user will see a welcome page, where a new project can be created or an existing project can be browsed.

External users cannot create new projects.

  1. Click the New project button.
  2. In the new project window (Picture 3) enter the name of the project, description and the privacy-settings (visibility level). You can also import repositories from external systems, such as Github.
  3. Click Create Project. The new project is done.


Picture 3: New project

Configuring the client for use

In order to obtain a local copy of a repository, you will need to install a Git-client on your computer.

For centrally managed Aalto computers, the Software Self-service portal has one available, SW_Git_Aalto.

To login with Git-client (https) to a repository, use Aalto-credentials:

  • Username: username@aalto.fi
  • Password: Aalto password

Git global setup:

Configuring your username, the information can be found inside the site of a repository (https://version.aalto.fi/your_username/repository_name).

git config --global user.name "your.username"
git config --global user.email "Aalto email-address"
Create a new repository:
git clone http://version.aalto.fi/your_username/Testproject.git 
cd Testproject
touch README.md
git add README.md
git commit -m "add README"
git push -u origin master
Existing folder or Git repository:
cd existing_folder
git init
git remote add origin http://version.aalto.fi/your_username/Testproject.git
git add .
git commit -m "Initial commit"
git push -u origin master

Size limit of a repository

Currently, the size of a repository has not been limited but avoid use the service as a storage for large files.

More information regarding the usage of GIT

For more information, how to use GIT as a version control system, feel free to familiarize yourself with the Pro Git – book composed by Scott Chacon & Ben Straub, link to the book below:


GitLab also provides comprehensive user guides; feel free to familiarize yourself with them at https://version.aalto.fi/gitlab/help


Contact information will be used only in case we need more information about feedback.
Please send only feedback about this instruction. If you have IT-related problems, please send a request to servicedesk@aalto.fi