> ## 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.

# Erste Schritte auf Square Cloud mit C#

> Erfahren Sie, wie Sie auf Square Cloud mit C# starten

## 🚀 Einführung

* Bevor Sie beginnen, stellen Sie sicher, dass .NET (Dotnet) auf Ihrem System installiert ist. Falls noch nicht vorhanden, können Sie es von der [offiziellen Dotnet-Website](https://dotnet.microsoft.com/en-us/download) herunterladen.
* Als Nächstes müssen Sie ein Konto bei Square Cloud erstellen, was über die [Anmeldeseite](https://squarecloud.app/de/signup) möglich ist. Sie können Ihre E-Mail, GitHub oder beides verwenden, um das Konto zu erstellen.
* Schließlich benötigen Sie einen aktiven kostenpflichtigen Plan auf Ihrem Konto. Sie können unsere Pläne einsehen und einen entsprechend Ihren Bedürfnissen [hier](https://squarecloud.app/de/pricing) erwerben.

## ⚙️ Konfiguration der squarecloud.app-Datei

<Note>
  Wenn du deine Anwendung über die Square Cloud Website hochlädst, kannst du diesen Abschnitt ignorieren. Die Website erstellt die `squarecloud.app` Konfigurationsdatei automatisch für dich.
</Note>

<Card title="Mehr erfahren: So erstellst du die Konfigurationsdatei für Square Cloud." icon="link" href="https://docs.squarecloud.app/de/getting-started/config-file">
  Die squarecloud.app Datei ist eine Konfigurationsdatei, die zur
  Konfiguration deiner Anwendung verwendet wird; sie dient dazu, den Namen, die
  Beschreibung, die Version, die Hauptdatei und weiteres zu definieren.
</Card>

## 📄 Erforderliche Dateien

* **project/project.csproj** (Beispiel einer Hauptdatei).
  <Note>Im obigen Beispiel befindet sich die Hauptdatei der Anwendung in einem Ordner. Wenn sich Ihre Konfigurationsdatei ebenfalls in einem Ordner befindet, müssen Sie den Pfad im Feld `MAIN` definieren, zum Beispiel: `MAIN=folder/file.csproj`</Note>
* [squarecloud.app](https://docs.squarecloud.app/de/getting-started/config-file) (Datei mit der Square Cloud-Konfiguration).

## ▶️ So starten Sie Ihre Anwendung

* Wenn das Feld `START` in der Konfigurationsdatei nicht definiert ist, verwendet Square Cloud standardmäßig den Prozess `restore & run`, um Ihre Anwendung zu starten. Wenn das Feld `START` definiert ist, wird der darin enthaltene Wert direkt ausgeführt. Weitere Informationen zu den Parametern der Konfigurationsdatei finden Sie unter [Konfigurationsparameter](https://docs.squarecloud.app/de/getting-started/config-file#configuration-parameters).

* Square Cloud verwendet `dotnet restore`, um die Projektabhängigkeiten wiederherzustellen, und `dotnet run --project MAIN`, um das in `MAIN` angegebene Projekt zu kompilieren und auszuführen.

## 🖥️ Vorbereitung des Projekts

Bevor Sie Ihr Projekt auf Square Cloud hosten, prüfen Sie zunächst, ob die Projektdateien ordnungsgemäß für das Hosting konfiguriert sind.

<Warning>Die Konfigurationsdatei (`squarecloud.app/.config`) muss sich im Stammverzeichnis der Zip-Datei befinden. Andernfalls kann Square Cloud sie während des Deploys nicht finden.</Warning>

## 📤 So hosten Sie Ihr Projekt

Nachdem Sie nun alle Dateien für Ihr C#-Projekt vorbereitet haben, besteht der nächste Schritt darin, sie auf Square Cloud hochzuladen und Ihre Anwendung online zu stellen. Es gibt mehrere Möglichkeiten zum Hochladen, aber wir behandeln zwei: über das Dashboard oder über die CLI.

### Über das Dashboard

<Steps>
  <Step title="Upload-Seite aufrufen">
    Rufe die [Upload-Seite](https://squarecloud.app/de/dashboard/new) auf und lade die ZIP-Datei deines Projekts hoch.
  </Step>

  <Step title="Umgebung konfigurieren">
    Nachdem du deine ZIP-Datei hochgeladen hast, musst du den Namen, die Hauptdatei oder Runtime-Umgebung und weitere Einstellungen für dein Projekt konfigurieren.\
    Wenn du ein Web-Projekt hochlädst, achte darauf, "Web Publication" auszuwählen und deinem Projekt eine Subdomain zuzuweisen.
  </Step>

  <Step title="Projekt bereitstellen">
    Klicke abschließend auf die Schaltfläche "Deploy", um dein Projekt auf Square Cloud zu hosten.\
    Nach dem Deploy kannst du den Status und die Logs deines Projekts über das Dashboard überwachen.

    <Frame>
      <img src="https://cdn.squarecloud.app/docs/articles/dashboard/uploading.gif" alt="Anwendung wird auf Square Cloud hochgeladen" style={{ borderRadius: "0.2rem" }} />
    </Frame>
  </Step>
</Steps>

### Über die CLI

Um diese Methode zu nutzen, musst du eine Konfigurationsdatei mit dem Namen `squarecloud.app` im Stammverzeichnis deines Projekts erstellen. Diese Datei enthält die notwendige Konfiguration für dein Projekt.

<Card title="Mehr erfahren: So erstellst du die Konfigurationsdatei für Square Cloud." icon="link" href="/de/getting-started/config-file">
  Die Datei squarecloud.app ist eine Konfigurationsdatei, mit der deine Anwendung konfiguriert wird; sie dient dazu, deine Umgebung zu definieren.
</Card>

<Steps>
  <Step title="CLI installieren">
    Zuerst musst du die CLI in deiner Umgebung installiert haben. Falls du sie noch nicht hast, führe den folgenden Befehl in deinem Terminal aus:

    ```
    npm install -g @squarecloud/cli
    ```

    Falls du sie bereits hast, empfehlen wir, sie zu aktualisieren. Führe dazu den folgenden Befehl in deinem Terminal aus:

    <Tabs>
      <Tab title="Windows">
        ```bash theme={null}
        squarecloud update
        ```
      </Tab>

      <Tab title="Linux, macOS und WSL">
        ```bash theme={null}
        curl -fsSL https://cli.squarecloud.app/install | bash
        ```
      </Tab>
    </Tabs>
  </Step>

  <Step title="Authentifizieren">
    Um dich zu authentifizieren und weitere CLI-Befehle zu nutzen, findest du deinen Autorisierungsschlüssel [hier](https://squarecloud.app/de/account/security), indem du auf "Request API Key" klickst. Nachdem du deinen Autorisierungsschlüssel erhalten hast, führe den folgenden Befehl aus:

    ```bash theme={null}
    squarecloud auth login
    ```
  </Step>

  <Step title="Projekt hochladen">
    Um deine Anwendung schließlich über die CLI auf Square Cloud bereitzustellen, musst du den folgenden Befehl ausführen:

    ```bash theme={null}
    squarecloud upload 
    ```

    Oder falls du die ZIP-Datei manuell erstellt hast, kannst du Folgendes verwenden:

    ```bash theme={null}
    squarecloud upload --file <path/to/zip> 
    ```
  </Step>
</Steps>

## Kontaktiere uns

Falls du weiterhin **technische Schwierigkeiten** hast, steht dir unser **spezialisiertes Support-Team** zur Verfügung. [**Kontaktiere uns**](https://squarecloud.app/de/support) und wir helfen dir gerne, jedes Problem zu lösen.