Open Infrastructure

h1. The ungleich GitLab guide

{{>toc}}

h2. Status

This article is *IN PROGRESS*

h2. Overview

GitLab is installed on: *http://code.ungleich.ch*

h2. What is GitLab

Gitlab is a self hosted solution for git management. (Also available as a hosted version directly on [GitLab Pricing](https://about.gitlab.com/pricing/)

Since gitlab is under heavy development, please see [GitLab](https://about.gitlab.com/) for all functions available.

h3. What do ungleich use GitLab for

We trying to move all our public repositories from github.com to our self hosted version of GitLab. The private repositories are currently all ported from [gitolite](http://gitolite.com/gitolite/index.html). 

The reason we moved from gitolite to GitLab is rather simple: More features and integrations.

h2. Integration into ungleich services

The user authentication is done with our ldap server (See [[The ungleich LDAP guide]]). Other services are currently not integrated.

h2. How to add a repository

Go to *Projects/Your Projects* then you are able to create a *New project*.

In the next menu you are able to define under which group the project will be and further configurations. 

h2. How to update

As an administrator you can go to the *Admin Area* and a small window will show you if your instance is *up to date* or not.

If you need to do an update login to your GitLab host via ssh and then simply run (assuming it is a Devuan / Debian / *buntu):

<pre>

apt update; apt upgrade

</pre>

The update scripts (using chef) from GitLab will take care of the rest.

h2. Resources