Git-Versionskontrolle: Repositories in cPanel hosten und verwalten

Git-Versionskontrolle: Repositories in cPanel hosten und verwalten

Mit der Git-Versionskontrolle in cPanel können Sie Git-Repositories direkt in Ihrem Hosting-Konto erstellen, klonen und verwalten. Git eignet sich hervorragend, um Änderungen an Website-Dateien, Templates, Themes, Assets oder Softwareprojekten nachvollziehbar zu organisieren. Statt Dateien manuell zu überschreiben, arbeiten Sie mit Versionen, Commits und Branches.

Für Entwickler, Agenturen und fortgeschrittene Website-Betreiber ist Git ein wichtiger Bestandteil eines sauberen Workflows. Änderungen können lokal vorbereitet, getestet und anschliessend gezielt auf den Server übertragen werden. So behalten Sie besser den Überblick, welche Dateien wann und warum geändert wurden.

Die Git-Funktion in cPanel ist besonders nützlich, wenn Sie ein bestehendes Projekt von einer Plattform wie GitHub, GitLab oder Bitbucket auf Ihr Hosting-Konto klonen möchten oder wenn Sie ein neues Repository direkt auf dem Server anlegen wollen. Je nach Hosting-Konfiguration können Sie zusätzlich Deployments verwenden, um Dateien kontrolliert in ein Zielverzeichnis zu übertragen.

Was ist Git und warum ist es sinnvoll?

Git ist ein Versionskontrollsystem. Es speichert nicht einfach nur Dateien, sondern dokumentiert Änderungen am Projektverlauf. Jede Änderung kann als sogenannter Commit gespeichert werden. Dadurch lässt sich später nachvollziehen, welche Dateien geändert wurden, wann die Änderung erfolgt ist und welche Beschreibung dazu hinterlegt wurde.

Git ist besonders hilfreich, wenn:

• mehrere Personen an einem Projekt arbeiten,
• Änderungen nachvollziehbar dokumentiert werden sollen,
• neue Funktionen zuerst getestet werden sollen,
• ein sicherer Deployment-Prozess gewünscht ist,
• Code nicht mehr per FTP „blind“ überschrieben werden soll,
• eine Website aus einem Repository heraus gepflegt wird.

Gerade bei professionellen Websites ist Git ein grosser Vorteil. Statt einzelne Dateien manuell über FTP hochzuladen, können Änderungen kontrolliert übernommen werden. Das reduziert Fehler und macht die Entwicklung langfristig nachvollziehbarer.

Was kann die Git-Funktion in cPanel?

Die Git-Versionskontrolle in cPanel bietet eine grafische Oberfläche für grundlegende Repository-Aufgaben. Sie können damit Repositories erstellen, bestehende Repositories klonen, cPanel-verwaltete Repositories anzeigen und bestimmte Verwaltungsaktionen ausführen.

Typische Funktionen sind:

• neue Git-Repositories im Hosting-Konto erstellen,
• bestehende Repositories von externen Quellen klonen,
• bestehende lokale Git-Repositories zur cPanel-Verwaltung hinzufügen,
• Repository-Informationen in einer Übersicht anzeigen,
• Branches auswählen oder verwalten, soweit von der Oberfläche unterstützt,
• Änderungen abrufen oder deployen, sofern eingerichtet,
• den Verlauf über Gitweb anzeigen,
• Repositories aus der cPanel-Verwaltung entfernen.

Die cPanel-Oberfläche ersetzt jedoch nicht alle Git-Funktionen der Kommandozeile. Für fortgeschrittene Aufgaben wie komplexe Branch-Strategien, Merge-Konflikte, SSH-Key-Konfiguration, mehrere Remotes oder individuelle Git-Hooks benötigen Sie normalerweise die Kommandozeile.

Repository erstellen oder Repository klonen?

Beim Einrichten eines Git-Repositories in cPanel gibt es grundsätzlich zwei typische Wege: Sie erstellen ein neues Repository direkt im Hosting-Konto oder Sie klonen ein bereits bestehendes Repository von einer externen Plattform.

Ein neues Git-Repository in cPanel einrichten

Die genaue Bezeichnung der Felder kann je nach cPanel-Version und Sprache leicht variieren. Der grundsätzliche Ablauf ist jedoch ähnlich.

Schritt-für-Schritt-Anleitung

1. Melden Sie sich in cPanel an.
2. Öffnen Sie im Bereich Dateien die Funktion Git-Versionskontrolle beziehungsweise Git Version Control.
3. Klicken Sie auf Erstellen beziehungsweise Create.
4. Entscheiden Sie, ob Sie ein bestehendes Repository klonen oder ein neues Repository erstellen möchten.
5. Geben Sie bei einem Clone die Clone-URL des externen Repositories ein.
6. Legen Sie den Repository-Pfad fest, also das Verzeichnis, in dem das Repository gespeichert werden soll.
7. Vergeben Sie einen aussagekräftigen Anzeigenamen.
8. Prüfen Sie alle Angaben sorgfältig.
9. Klicken Sie auf Erstellen, um das Repository anzulegen.

Wenn Sie ein externes Repository klonen, kann der Vorgang je nach Grösse des Projekts einige Zeit dauern. Währenddessen sind bestimmte Aktionen in der Oberfläche möglicherweise vorübergehend nicht verfügbar.

Clone-URL: HTTPS oder SSH?

Beim Klonen eines externen Repositories benötigen Sie eine Clone-URL. Diese kann je nach Plattform und Zugriffsart unterschiedlich aussehen.

cPanel erlaubt für Clone-URLs bestimmte Formate, darunter URLs mit http://, https://, ssh://, git:// oder SSH-ähnliche Formate wie user@example.com:path. Zugangsdaten sollten nicht direkt als Benutzername-Passwort-Kombination in der URL hinterlegt werden.

Repository-Pfad richtig wählen

Der Repository-Pfad bestimmt, wo das Git-Repository in Ihrem Hosting-Konto gespeichert wird. Dieser Pfad sollte bewusst gewählt werden. Nicht jeder Ordner ist geeignet, und bestimmte Systemverzeichnisse sind für cPanel-verwaltete Repositories gesperrt.

Geeignete Beispiele können sein:

• /home/benutzer/repositories/mein-projekt
• /home/benutzer/git/mein-theme
• /home/benutzer/public_html/projekt, wenn das Repository bewusst direkt im Webverzeichnis liegen soll

Für produktive Websites ist es häufig sauberer, das eigentliche Repository nicht direkt als öffentliches Webverzeichnis zu verwenden, sondern ein separates Deployment in das gewünschte Zielverzeichnis einzurichten. Dadurch vermeiden Sie, dass Entwicklungsdateien, Konfigurationsdateien oder nicht benötigte Projektdateien öffentlich erreichbar werden.

Pfadeinschränkungen und verbotene Zeichen

cPanel setzt Einschränkungen für Repository-Pfade, um Systembereiche zu schützen und technische Probleme zu vermeiden. Repositories können nicht in bestimmten cPanel-kontrollierten Verzeichnissen erstellt werden. Dazu gehören unter anderem Verzeichnisse wie .cpanel, .ssh, .trash, etc, logs, mail, ssl, tmp oder ähnliche Systembereiche. Auch bestimmte Sonderzeichen sind in Repository-Pfaden nicht erlaubt.

Ein sauberer Repository-Pfad könnte zum Beispiel git/mein-projekt oder repositories/kundenwebsite sein. Vermeiden Sie Namen wie Mein Projekt 2026! oder Pfade mit Sonderzeichen.

Repository verwalten: Manage, History und Remove

Nach dem Erstellen oder Klonen eines Repositories erscheint es in der cPanel-Übersicht. Dort stehen je nach cPanel-Version und Repository-Status verschiedene Aktionen zur Verfügung.

• Verwalten / Manage: Öffnet die Einstellungen des Repositories. Hier können Sie cPanel-verwaltete Einstellungen prüfen, Änderungen abrufen oder ein Deployment ausführen, sofern dies eingerichtet ist.
• Verlauf / History: Öffnet die Gitweb-Ansicht. Dort können Sie Commits, Dateien und den Projektverlauf im Browser ansehen.
• Entfernen / Remove: Entfernt das Repository aus der cPanel-Verwaltung. Dabei wird die cPanel-Verwaltung beendet; die Repository-Daten im Verzeichnis werden laut cPanel-Dokumentation dadurch nicht automatisch gelöscht.

Deployment mit Git in cPanel

Ein Repository allein bedeutet noch nicht automatisch, dass Ihre Website live aktualisiert wird. Bei einem Deployment werden Dateien aus dem Repository in ein Zielverzeichnis übertragen oder dort aktualisiert. In cPanel kann ein Deployment je nach Einrichtung manuell über die Oberfläche oder über Git-Hooks erfolgen.

Für cPanel-Deployments wird häufig eine Datei namens .cpanel.yml verwendet. Diese Datei beschreibt, welche Aktionen beim Deployment ausgeführt werden sollen, zum Beispiel das Kopieren bestimmter Dateien in ein Zielverzeichnis.

Ein vereinfachtes Beispiel kann so aussehen:

---
deployment:
  tasks:
    - export DEPLOYPATH=/home/benutzer/public_html/
    - /bin/cp -R * $DEPLOYPATH

Dieses Beispiel dient nur zur Veranschaulichung. Der Pfad /home/benutzer/public_html/ muss an Ihr tatsächliches Hosting-Konto angepasst werden. Ausserdem sollte nicht jedes Projekt pauschal mit cp -R * deployt werden, da dadurch auch Dateien kopiert werden könnten, die nicht öffentlich erreichbar sein sollten.

.git-Verzeichnis und Sicherheit

Ein Git-Repository enthält ein internes Verzeichnis namens .git. Darin befindet sich die Versionshistorie des Projekts. Dieses Verzeichnis ist technisch wichtig und darf nicht manuell verändert oder gelöscht werden.

cPanel trifft Schutzmassnahmen, damit das .git-Verzeichnis bei cPanel-verwalteten Repositories nicht öffentlich über den Browser zugänglich ist. Trotzdem sollten Sie bei produktiven Websites vorsichtig sein, wenn Repositories direkt im Webverzeichnis liegen. Eine saubere Trennung von Repository und Deployment-Ziel ist häufig die sicherere Struktur.

Empfohlener Workflow für Websites

Ein sauberer Git-Workflow hilft, Fehler zu vermeiden und Änderungen nachvollziehbar zu machen. Für viele Websites eignet sich folgender Ablauf:

1. Entwickeln und testen Sie Änderungen lokal auf Ihrem Computer.
2. Speichern Sie Änderungen mit aussagekräftigen Git-Commits.
3. Übertragen Sie die Änderungen in ein zentrales Repository, zum Beispiel bei GitHub, GitLab oder Bitbucket.
4. Klonen oder aktualisieren Sie das Repository in cPanel.
5. Führen Sie ein kontrolliertes Deployment in das gewünschte Webverzeichnis aus.
6. Testen Sie die Website nach dem Deployment im Browser.
7. Prüfen Sie bei Problemen den Git-Verlauf und die zuletzt deployten Änderungen.

Dieser Ablauf ist deutlich sicherer als spontane Änderungen direkt auf dem Live-Server. Besonders bei Kundenprojekten, Shops oder produktiven Websites sollten Änderungen möglichst nachvollziehbar und reproduzierbar sein.

Git und WordPress: Was ist sinnvoll?

Git kann auch bei WordPress-Projekten nützlich sein, sollte aber bewusst eingesetzt werden. WordPress besteht aus Dateien und einer Datenbank. Git versioniert Dateien, nicht automatisch Datenbankinhalte wie Beiträge, Seiten, Einstellungen oder Bestellungen.

Für WordPress eignet sich Git zum Beispiel für:

• eigene Themes,
• eigene Plugins,
• Child-Themes,
• Konfigurationsdateien ohne sensible Zugangsdaten,
• Projektdateien für Entwicklung und Deployment.

Nicht sinnvoll ist es in der Regel, den gesamten Ordner wp-content/uploads mit grossen Mediendateien oder Cache-Verzeichnisse vollständig zu versionieren. Solche Inhalte können ein Repository unnötig aufblähen.

Was gehört nicht in ein Git-Repository?

Nicht jede Datei sollte in Git gespeichert werden. Besonders sensible oder automatisch generierte Dateien sollten ausgeschlossen werden.

• Zugangsdaten und Passwörter
• .env-Dateien mit vertraulichen Einstellungen
• Cache-Verzeichnisse
• temporäre Dateien
• grosse Upload- oder Mediendateien, sofern sie nicht bewusst versioniert werden sollen
• lokale Entwicklungsdateien
• Backups und ZIP-Archive
• generierte Abhängigkeiten, wenn sie über Paketmanager reproduzierbar sind

Dafür wird üblicherweise eine Datei namens .gitignore verwendet. In dieser Datei legen Sie fest, welche Dateien oder Ordner Git ignorieren soll.

# Beispiel für eine einfache .gitignore
.env
*.log
cache/
tmp/
node_modules/
vendor/
*.zip

Welche Einträge sinnvoll sind, hängt vom Projekt ab. Bei PHP-, Node.js-, WordPress- oder statischen Websites unterscheiden sich die typischen Ausschlüsse.

Häufige Probleme mit Git in cPanel

Best Practices für Git-Repositories im Webhosting

• Nutzen Sie klare Repository-Namen ohne Sonderzeichen.
• Legen Sie Repositories möglichst nicht direkt in sensiblen Systemordnern an.
• Trennen Sie Repository und öffentliches Webverzeichnis, wenn ein Deployment-Prozess möglich ist.
• Speichern Sie keine Passwörter, API-Schlüssel oder Zugangsdaten im Repository.
• Verwenden Sie eine passende .gitignore-Datei.
• Dokumentieren Sie Änderungen mit aussagekräftigen Commit-Nachrichten.
• Testen Sie Deployments nach jeder Änderung.
• Bearbeiten Sie den .git-Ordner niemals manuell.
• Verwenden Sie private Repositories für vertrauliche Projekte.
• Prüfen Sie bei externen Repositories die SSH- und Zugriffsrechte sorgfältig.

FAQ zur Git-Versionskontrolle in cPanel

Kann ich Git in cPanel ohne SSH nutzen?

Ja, eingeschränkt. Sie können über die cPanel-Oberfläche Repositories erstellen, klonen, anzeigen und entfernen. Für private Repositories, SSH-Schlüssel, mehrere Remote-Repositories oder komplexere Git-Befehle ist jedoch in der Regel Shell-/SSH-Zugriff erforderlich.

Kann ich ein privates GitHub-Repository klonen?

Ja, grundsätzlich ist das möglich, erfordert aber zusätzliche Authentifizierung. Häufig wird dafür eine SSH-Key-Konfiguration benötigt. Ohne korrekt eingerichtete Schlüssel schlägt der Zugriff auf private Repositories meist fehl.

Wird meine Website automatisch aktualisiert, wenn ich ein Repository klone?

Nein, nicht automatisch in jedem Fall. Ein geklontes Repository liegt zunächst in einem Verzeichnis Ihres Hosting-Kontos. Damit Änderungen live auf der Website erscheinen, muss das Repository entweder direkt im Webverzeichnis liegen oder ein Deployment in das Webverzeichnis eingerichtet sein.

Was ist Gitweb?

Gitweb ist eine Browseransicht, mit der Sie den Verlauf, Commits und Inhalte eines Repositories ansehen können. Sie dient der Übersicht und Analyse, ersetzt aber keine vollständige Entwicklungsumgebung.

Was passiert, wenn ich ein Repository aus cPanel entferne?

Das Repository wird aus der cPanel-Verwaltung entfernt und erscheint nicht mehr in der Git-Oberfläche. Die Dateien im Repository-Verzeichnis werden dabei laut cPanel-Dokumentation nicht automatisch gelöscht. Wenn Sie die Daten vollständig entfernen möchten, müssen Sie sie separat löschen.

Sollte ich mein Repository direkt in public_html ablegen?

Das ist technisch möglich, aber nicht immer empfehlenswert. Für viele Projekte ist es sicherer, das Repository ausserhalb des öffentlichen Webverzeichnisses zu speichern und nur die benötigten Dateien gezielt nach public_html zu deployen.

Kann Git meine Datenbank versionieren?

Nein. Git versioniert Dateien. Datenbankinhalte wie WordPress-Beiträge, Shop-Bestellungen oder CMS-Einstellungen werden dadurch nicht automatisch versioniert. Dafür sind separate Backup- oder Migrationsstrategien erforderlich.