wikijs/services/gitea.md

---
title: Gitea
description: 
published: true
date: 2021-04-13T17:06:49.806Z
tags: 
editor: markdown
dateCreated: 2021-03-24T20:04:53.409Z
---

# Nutzung von Gitea

Der Zugang zu Gitea ist aktuell eingeschränkt, da (noch) keine Quota umgesetzt ist. Möchtest du Gitea nutzen musst du den Zugang zunächst beantragen.

## Zugang beantragen <a name="application" id="application"></a>

Der Zugang zu Gitea kann über ein Add-On im [Pretix](/de/services/pretix) System beantragt werden. Fordere einfach [Gutschein](/de/services/webstly#voucher) an und löse diesen unter [membership.bstly.de](https://membership.bstly.de) ein. Nach Genehmigung des Antrages bekommst du wieder eine E-Mail zum einlösen des Token für deinen Account. Nachdem du das Token eingelöst hast ist der Zugang für dich aktiviert.

# Basis Anleitung <a name="guide" id="guide"></a>

Dies ist nur eine kurze Anleitung um mit *Gitea* und *Git* zu starten. Eine Anleitung zur Installation von *Git* findest du bei [Atlassian.com](https://www.atlassian.com/de/git/tutorials/install-git). Ausführlichere Anleitungen zum fortgeschrittenen Themen wie *Branches* oder *Pull-Requests* findest du sicher über eine Suchmaschine deiner Wahl oder frage beim [Support](/de/help#support) nach.

> Da dein Zugang auch über *OIDC* eingerichtet wird, hast du kein Passwort für diesen Service gesetzt. Es wird daher empfohlen deine Repositories alle über den [SSH-Zugang](#ssh) zu verwalten.
{.is-warning}

## SSH-Zugang <a name="ssh" id="ssh"></a>

> Eine einfach Anleitung zum erzeugen von *SSH-Schlüsseln* findest du bei [Heise.de](https://www.heise.de/tipps-tricks/SSH-Key-erstellen-so-geht-s-4400280.html).
{.is-info}

Nachdem du eingeloggt bist, klicke rechts oben auf dein Avatar und wähle **Einstellungen** aus. Anschließend wählst du den Tab **SSH- / GPG-Schlüssel** aus. Klicke bei **SSH-Schlüssel verwalten** auf **Schlüssel hinzufügen**, kopiere deinen *Öffentlichen SSH Schlüssel* in das Textfeld **Inhalt** und lade so deinen Schlüssel hoch.

## Neues Repository erstellen <a name="repository" id="repository"></a>

Eine neues Repository erstellst du einfach über das **+**-Symobol oben rechts. Bis auf einen Namen musst du grundsätzlich nichts weiter angeben. Du solltest dir aber noch überlegen ob dein Repository *öffentlich* (Standard) ist oder du lieber ein *privates* Repository anlegen möchtest. Für ein privates Reporitory aktivere einfach die entsprechende Schaltfläche.

### Repository lokal einrichten <a name="local" id="local"></a>

Um dein Repository nun auf deinem Computer einzurichten kannst du folgende Befehle verwenden. 
```
git init
git config --global user.name "{username}"
git config --global user.email "{username}@we.bstly.de"
git checkout -b main
```
Nun kannst du Dateien hinzufügen wie z.B. eine `README.md` mit einer Beschreibung. Anschließend kannst mit folgenden Befehlen deine ersten Dateien hochladen und die Verbindung zu deinem *Gitea* Repository herstellen.
> Achte auf die korrekte Url. Wenn du kein Passwort angegegen hast, wähle undebdingt die *SSH*-Url aus.
{.is-warning}

```
git add .
git commit -m "{first commit}"
git remote add origin ssh://gitea@git.bstly.de:222/{username}/{repository}.git
git push -u origin main
```

## Lokale Änderungen übernehmen

Hast du Dateien in deinem lokalen Repository verändert, hinzugefügt oder gelöscht kannst du diese Änderungen mit drei kurzen Befehlen in dein *Gitea* Repository übernehmen.
```
git add .
git commit -m "{commit message}"
git push
```

## Entfernte Änderungen übernehmen

Haben sich Dateien in deinem *Gitea* Repository geändert reicht der Befehl `git pull` in der Regel aus um die Änderungen in dein lokales Reposirtoy zu übernehmen.