Instructions to use Git

From June 2017, the FSFE offers comfortable Git hosting to its supporters and volunteers. This page and its subpages will give you an overview of the service and some beginner guides for basic operations. Because the underlying Free Software project (Gitea) is in heavy development, some steps may change. Please help keeping these pages up-to-date, therefore.


Git is similar to SVN which you may already know from the FSFE's website. It's an advanced version control system which keeps track of changed files and helps you to test major changes with different branches of the code without interfering with the main branch of the data ("master").

Moreover, on you are able to use even more features that are very helpful for collaboration with other contributors. If you have ever used GitLab or GitHub before you will quickly learn Gitea. But even if you're completely new to Git you'll understand it soon.

Here are some of the features you might find helpful


Every User on has its own space. For example, all respositories of the FSFE user max.mehl are available under A repository (like max.mehl's share buttons is something like a project. It can contain various files and folders. With each repository, there is a Issues and a Wiki section which you, contributors, and other people can use.

For larger projects with much collaboration, there're also Organizations, like the one for FSFE. Like users, these can contain several repositories but they're not bound to a single user. Instead, the organizations administrators can define various user roles with specific access permissions. For example, a new campaign could form an organization and contain multiple repositories, e.g. the website, promotion materials, or documents you'd like to open up for collaboration.

The third structural form is a Mirror. Basically, this is a copy of another repository, either in or on an external platform like GitHub. Mirrors are kept up-to-date regularly. As a beginner, you won't use mirrors probably.

Guides on specific actions

There are hundreds of guides out there so we won't get into deep details here (e.g. GitHub has some popular howtos. But you'll find instructions for basic operations for a non-techy audience. Help expanding existing guides or add new ones!

TechDocs/Git (last edited 2017-06-19 06:02:18 by max.mehl)