---
title: Ihr erster Build
description: Was nach der Verbindung eines Repositorys passiert – Build-Phasen, der Tab „Deployments“ und was bei Fehlern zu prüfen ist.
---

> **For AI agents:** the complete documentation index is at [llms.txt](/docs/llms.txt). Append `.md` to any page URL for its markdown version.

Ihr erster Build startet automatisch, sobald Sie ein Repository verbinden.

## Automatische Builds

Wenn Sie ein Repository verbinden, startet Jamdesk sofort einen initialen Build. Jeder weitere Push in Ihren verbundenen Branch löst automatisch einen neuen Build aus.

## Build-Fortschritt

Verfolgen Sie Ihren Build im Dashboard:

<Steps>
  <Step title="Warteschlange">
    Ihr Build wartet auf den Start. Zu Spitzenzeiten kann es eine kurze Warteschlange geben.
  </Step>
  <Step title="Klonen">
    Jamdesk ruft den Inhalt Ihres Repositorys von GitHub ab.
  </Step>
  <Step title="Validieren">
    Ihre `docs.json`- und MDX-Dateien werden auf Fehler geprüft.
  </Step>
  <Step title="Build wird erstellt">
    MDX wird mit Syntaxhervorhebung und Suchindexierung in optimiertes HTML kompiliert.
  </Step>
  <Step title="Wird bereitgestellt">
    Die erstellten Dateien werden in das globale CDN hochgeladen.
  </Step>
  <Step title="Live">
    Ihre Dokumentation ist unter der URL Ihres Projekts verfügbar.
  </Step>
</Steps>

## Ihre Live-Dokumentation anzeigen

Sobald der Build abgeschlossen ist, klicken Sie im Dashboard auf **View Site** oder rufen Sie `https://your-project.jamdesk.app` auf.

Wenn Sie eine benutzerdefinierte Domain konfiguriert haben, ist Ihre Dokumentation auch dort verfügbar.

## Manuellen Build starten

Müssen Sie einen Build starten, ohne Änderungen zu pushen?

1. Öffnen Sie Ihr Projekt im [Dashboard](https://dashboard.jamdesk.com)
2. Öffnen Sie **Settings**
3. Klicken Sie auf **Rebuild**

Verwenden Sie diese Funktion nach Änderungen an Umgebungsvariablen oder um einen neuen Build zu erzwingen.

## Wenn Ihr Build fehlschlägt

Fehlgeschlagene Builds zeigen eine Fehlermeldung im Dashboard an. Häufige Ursachen:

- Ungültige Syntax in `docs.json`
- MDX-Syntaxfehler
- Fehlende Seiten, auf die in der Navigation verwiesen wird

<Card title="Referenz zu Build-Fehlern" icon="circle-exclamation" href="/de/help/troubleshooting/error-reference">
  Hier finden Sie häufige Fehlercodes und Informationen zu ihrer Behebung
</Card>

## Verwandte Artikel

<Columns cols={2}>
  <Card title="Builds auslösen" icon="play" href="/de/builds/triggering">
    Erfahren Sie mehr über automatische und manuelle Build-Auslöser
  </Card>
  <Card title="Builds überwachen" icon="chart-line" href="/de/builds/monitoring">
    Verfolgen Sie den Build-Fortschritt und zeigen Sie Protokolle an
  </Card>
</Columns>