# Projekt öffnen und starten

Du öffnest den Projektordner im Editor, startest ein Terminal, lässt die Anwendung mit mp run-local laufen und siehst sie dir im Browser an.

> Source: https://www.mainpath.ai/de/docs/open-and-run/

## Den Projektordner öffnen

Aus der MainPath Toolbox öffnest du das Projekt unter **Projekte** mit dem Button für dein Werkzeug, alternativ im Editor über **Datei** → **Ordner öffnen** den Ordner `~/Documents/MainPath/<organisation>/<projekt>`. Öffne immer den übergeordneten Projektordner, damit Backend, App, Homepage und `local-configuration` nebeneinander liegen.

Im Remote-Workspace öffnest du über **Apps** auf der Workspace-Kachel VS Code im Browser oder verbindest dich per Remote Desktop; die Projektordner liegen im Home-Verzeichnis.

In VS Code, Cursor und Antigravity zeigt MainPath-Erweiterung `doppelt-digital.application-platform` eine Startseite mit allen Repositories, Links zu GitLab und Dokumentation und einem Start-Button für `mp run-local`.

## Ein Terminal öffnen

Öffne über **Terminal** → **Neues Terminal** ein Terminal und wechsle in das Repository; `ls` zeigt die Ordner:

```bash
cd backend
```

## Die Anwendung starten

```bash
mp run-local
```

Ein Backend startet zuerst Docker-Dienste wie Datenbank, Mailhog und PHPMyAdmin und dann den Entwicklungsserver, eine App den Entwicklungsserver ihres Stacks mit den Werten aus den `env`-Dateien, eine Homepage Hugo oder Astro auf dem Port des Repositorys.

Das Terminal zeigt die lokale Adresse, etwa `http://localhost:3000`; `mp ports` listet alle Ports. Bei Flutter-Apps gibst du das Ziel an, etwa `mp run-local chrome` oder `mp run-local ios-simulator`; `mp devices list` zeigt die Geräte, und mehrere Anwendungen laufen gleichzeitig in mehreren Terminals.

## Im Browser ansehen

Öffne die Adresse im Browser; viele Entwicklungsserver übernehmen Änderungen nach dem Speichern von selbst, sonst lade die Seite neu.

## Beenden

Drücke im Terminal **Strg+C**, auf dem Mac mit Control statt der Befehlstaste.

## Wenn etwas nicht startet

`mp doctor` prüft die Werkzeuge; fehlende installiert das Entwickler-Setup der MainPath Toolbox. Ist ein Port belegt, beende den alten Prozess oder Docker-Container; fehlt eine Laufzeit trotz Installation, stehst du nicht im Repository-Ordner mit der passenden `.tool-versions`. Eigene Werte gehören in `env/local.custom.env`, siehe [Umgebungsvariablen]({{< relref "environment-setup" >}}); weitere Optionen von `mp run-local` stehen unter [Anwendungen starten]({{< relref "workspace-ubuntu-dev-scripts" >}}).

Läuft die Anwendung, kannst du Änderungen von einem [KI-Agenten]({{< relref "work-with-ai-agents" >}}) vornehmen lassen.