> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Befehle und Einstellungen der VS Code-Erweiterung

> Alle Befehle der Square Cloud-Erweiterung für VS Code, ihre Einstellungen und Lösungen für häufige Probleme.

## Befehle

Öffne die Befehlspalette (`Ctrl+Shift+P` / `Cmd+Shift+P`) und tippe **Square Cloud** ein.

| Befehl | Wo er außerdem erscheint |
| - | - |
| `Square Cloud: Konto verbinden` | Anmeldeansicht, Statusleiste ohne verbundenes Konto |
| `Square Cloud: Erste Schritte` | Anmeldeansicht, `...`-Menü der Seitenleiste |
| `Square Cloud: Aktualisieren` | Titelleiste der Seitenleiste, Statusleiste |
| `Square Cloud: Neue Anwendung hochladen` | Titelleiste der Seitenleiste, leerer Bereich Anwendungen |
| `Square Cloud: Dienststatus anzeigen` | Fußzeile der Seitenleiste, mit verbundenem Konto |
| `Square Cloud: Datenbank erstellen` | `...`-Menü der Seitenleiste, leerer Bereich Datenbanken |
| `Square Cloud: Workspace erstellen` | `...`-Menü der Seitenleiste, leerer Bereich Workspaces |
| `Square Cloud: Meinen Einladungscode kopieren` | `...`-Menü der Seitenleiste |
| `Square Cloud: Konto trennen` | `...`-Menü der Seitenleiste |

Mit verbundenem Konto führt die Palette auch die Aktionen für Anwendungen und Datenbanken aus. Jede Aktion fragt, welche Anwendung oder Datenbank verwendet werden soll, und listet nur die auf, für die sie gilt: Starten bietet Anwendungen an, die nicht laufen, Stoppen und Neu starten die, die nicht gestoppt sind, die Edge-Tools nur Websites und Metriken nur Anwendungen mit 512 MB oder mehr.

| Gruppe | Befehle |
| - | - |
| Lebenszyklus | Anwendung starten..., Anwendung stoppen..., Anwendung neu starten... |
| Logs und Metriken | Logs der Anwendung anzeigen..., Echtzeit-Stream der Anwendung umschalten..., 24h-Metriken der Anwendung anzeigen... |
| Deploy | Dateien per Commit an Anwendung senden..., Snapshot der Anwendung herunterladen..., Snapshot der Anwendung wiederherstellen... |
| Konfiguration | Umgebungsvariablen der Anwendung bearbeiten..., Anwendung mit GitHub-Repository verknüpfen..., Anwendung vom GitHub-Repository trennen... |
| Edge (Websites) | Edge-Logs anzeigen..., Edge-Fehler anzeigen..., Edge-Performance anzeigen..., Edge-Cache leeren... |
| Sonstiges | Anwendung im Web-Dashboard öffnen..., Anwendungs-ID kopieren..., Anwendung löschen... |
| Datenbanken | Datenbank starten..., Datenbank stoppen..., TLS-Zertifikat der Datenbank herunterladen..., Datenbank löschen... |

Dieselben Aktionen findest du im Menü jeder Karte in der Seitenleiste: Klicke mit der rechten Maustaste auf eine Anwendung, eine Datenbank oder einen Workspace, oder nutze die ⋯-Schaltfläche.

## Einstellungen

| Einstellung | Standard | Beschreibung |
| - | - | - |
| `squarecloud.favApps` | `[]` | IDs deiner favorisierten Anwendungen, die oben in der Liste angezeigt werden. Der Stern auf jeder Karte verwaltet diese Einstellung, sodass du sie selten von Hand bearbeiten musst. |

## Aktivierung und Aktualisierung

Die Erweiterung wird nur bei Bedarf aktiviert: wenn der Workspace eine Datei `squarecloud.app` oder `squarecloud.config` enthält oder wenn du die Square Cloud-Seitenleiste öffnest, einen ihrer Befehle ausführst oder eine Konfigurationsdatei öffnest. Bis dahin hat sie keine Hintergrundaktivität.

Sobald sie aktiv ist, aktualisiert sie dein Konto alle **60 Sekunden**. Das Polling pausiert, solange das VS Code-Fenster nicht im Fokus ist, und aktualisiert, sobald du zurückkommst, damit ein untätiger Editor dein API-Kontingent nicht verbraucht. Wird ein Rate-Limit erreicht, pausiert das Polling im Hintergrund für einige Minuten, und die Seitenleiste behält, was bereits angezeigt wird.

## Fehlerbehebung

<AccordionGroup>
  <Accordion title="In der Seitenleiste wird nichts angezeigt">
    Prüfe, ob ein Konto verbunden ist: Ohne Konto zeigt die Seitenleiste den Anmeldebildschirm. Wenn Square Cloud nicht erreichbar ist, Anfragen pausiert oder sich in Wartung befindet, zeigt die Seitenleiste an, was davon zutrifft, mit den Schaltflächen **Erneut versuchen** und **Dienststatus**.
  </Accordion>

  <Accordion title="Deine Autorisierung ist abgelaufen oder wurde widerrufen">
    Autorisierungen gelten 90 Tage und können nicht unbemerkt im Hintergrund erneuert werden. Führe `Square Cloud: Konto verbinden` erneut aus. Du kannst eine Autorisierung jederzeit unter **Mein Konto → Authentifizierung** im [Dashboard](https://squarecloud.app/de/account/security) widerrufen.
  </Accordion>

  <Accordion title="Jemand hat dir einen Code oder Link zum Bestätigen geschickt">
    Gib ihn nicht ein. Wenn du den Code einer anderen Person bestätigst, verbindest du deren Editor mit deinem Konto. Wenn die Seite den eingefügten Code ablehnt, beginne in VS Code von vorn.
  </Accordion>

  <Accordion title="Upload schlägt mit einem Fehler wegen fehlender Konfiguration fehl">
    Der gewählte Ordner braucht in seinem Stammverzeichnis eine Datei `squarecloud.app` oder `squarecloud.config`. Siehe den [Leitfaden zur Konfigurationsdatei](/de/getting-started/config-file).
  </Accordion>

  <Accordion title="Upload schlägt fehl, weil die ZIP-Datei zu groß ist">
    ZIP-Dateien sind auf 100 MB begrenzt. Füge Build-Ausgaben, Caches und Abhängigkeitsordner zu [`squarecloud.ignore`](/de/getting-started/squarecloud-ignore) hinzu. `node_modules` und `.git` werden bereits weggelassen, und Abhängigkeiten werden auf der Plattform anhand deines Manifests installiert.
  </Accordion>

  <Accordion title="Ein Befehl ist mit einer Rate-Limit-Meldung fehlgeschlagen">
    Warte, bevor du es erneut versuchst. Das Polling im Hintergrund hält sich bereits von selbst zurück, und ständige neue Versuche halten das Limit nur aufrecht.
  </Accordion>

  <Accordion title="Alles andere diagnostizieren">
    Öffne **Anzeigen → Ausgabe** und wähle den Kanal **Square Cloud**, um ein Log jedes API-Aufrufs zu sehen, und füge es bei, wenn du einen Fehler auf [GitHub](https://github.com/squarecloudofc/vscode-extension) meldest.
  </Accordion>

  <Accordion title="Die Daten wirken veraltet">
    Klicke auf den Statusleisteneintrag oder das Aktualisieren-Symbol in der Titelleiste der Seitenleiste. Denk daran, dass das Polling pausiert, solange das Fenster nicht im Fokus ist.
  </Accordion>
</AccordionGroup>