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

# Bot-Hosting

> Hoste deine Discord-, WhatsApp- und Telegram-Bots auf der größten Plattform Lateinamerikas. Enterprise-Leistung, fortschrittliche Sicherheit und Entwicklungstools für dein Projekt.

<Frame>
  <img src="https://squarecloud.app/banners/de/bots.png" alt="Übersicht des Square Cloud Bots Dienstes" style={{ borderRadius: "0.2rem" }} />
</Frame>

## Warum Square Cloud wählen?

Wir sind die **größte Bot-Hosting-Plattform Lateinamerikas**, der **80 der 100 größten brasilianischen Discord-Server** vertrauen. Ein Bot steht und fällt mit seiner Uptime und seiner Latenz zu den Discord-, WhatsApp- und Telegram-Gateways — daher ist jede Ebene unseres Stacks, von der Hardware bis zum Netzwerk-Edge, darauf abgestimmt, deinen Prozess rund um die Uhr online und reaktionsschnell zu halten.

<CardGroup cols={2}>
  <Card title="Zweckgebaute Leistung" icon="bolt">
    Jeder Bot läuft auf **Enterprise Samsung NVMe SSDs** hinter **10-Gbit/s**-Uplinks, in einem isolierten Container mit **kernelerzwungenen CPU- und RAM-Grenzen** — sodass die Traffic-Spitze eines Nachbarn niemals zu deinem Latenzproblem wird.
  </Card>

  <Card title="Ein vollständiges Entwickler-Ökosystem" icon="code">
    **CLI**, **JavaScript- & Python-SDKs**, eine **VSCode-Erweiterung** und **GitHub Actions/Webhooks** für CI/CD. Deploye aus deinem Terminal, deinem Editor oder per `git push`.
  </Card>

  <Card title="Square Shield + Cloudflare" icon="shield-halved">
    Ein **Cloudflare-vorgeschalteter** Edge plus **Square Shield** hält deinen Bot innerhalb der Rate-Limits der Plattform-APIs (Discord und andere) und verhindert die Sperren und Cooldowns, die einen Bot offline nehmen.
  </Card>

  <Card title="Sofortige Snapshots" icon="server">
    **Ein-Klick-Wiederherstellungspunkte** ohne Aufpreis inklusive. Setze einen fehlerhaften Deploy in Sekunden zurück, ohne Datenverlust und ohne Ausfallzeit.
  </Card>
</CardGroup>

<Info>
  **Bewährt im großen Maßstab:** Unser Ruf wurde durch den Betrieb der Bots hinter einigen der geschäftigsten Communities Lateinamerikas erarbeitet — die Art von anhaltender Last mit hoher Ereignisrate, die schwache Infrastruktur klammheimlich entlarvt. Deiner läuft auf denselben Clustern.
</Info>

***

## Unterstützte Umgebungen

Wir bieten breite Kompatibilität, damit du mit deiner bevorzugten Technologie entwickeln kannst.

### Plattformen

<CardGroup cols={4}>
  <Card title="Discord" icon="discord" />

  <Card title="WhatsApp" icon="whatsapp" />

  <Card title="Telegram" icon="telegram" />

  <Card title="Twitter" icon="twitter" />

  <Card title="Instagram" icon="instagram" />

  <Card title="Facebook" icon="facebook" />

  <Card title="Slack" icon="slack" />

  <Card title="YouTube" icon="youtube" />
</CardGroup>

### Sprachen

<CardGroup cols={3}>
  <Card title="JavaScript" icon="node-js" href="../articles/getting-started-with-nodejs" />

  <Card title="Python" icon="python" href="../articles/getting-started-with-python" />

  <Card title="Java" icon="java" href="../articles/getting-started-with-java" />

  <Card title="Rust" icon="rust" href="../articles/getting-started-with-rust" />

  <Card title="Elixir" icon="droplet" href="../articles/getting-started-with-elixir" />

  <Card title="PHP" icon="php" href="../articles/getting-started-with-php" />

  <Card title="Go" icon="golang" href="../articles/getting-started-with-go" />

  <Card title="C#" icon="c" href="../articles/getting-started-with-csharp" />

  <Card title="Ruby" icon="gem" href="../articles/getting-started-with-ruby" />
</CardGroup>

<Info>
  Darüber hinaus unterstützen wir diverse weitere Sprachen und Bibliotheken. Unsere Infrastruktur ist flexibel, um sich an die Anforderungen deines Projekts anzupassen.
</Info>

***

## Hauptfunktionen

### Infrastruktur für Always-on-Workloads

Jeder Cluster läuft auf **Enterprise Samsung NVMe SSDs** mit **10-Gbit/s-Uplinks**, und dein Bot läuft in einem isolierten, unprivilegierten Container mit dedizierten CPU- und RAM-Grenzen. Isolation ist das, was "schnell auf dem Papier" in schnell in der Produktion verwandelt: Dein Prozess kämpft nie mit einem lauten Nachbarn um I/O oder CPU, sodass die Antwortzeiten auch unter anhaltender Ereignislast niedrig bleiben.

### Square Shield: innerhalb der Rate-Limits bleiben

Discord, WhatsApp und Telegram sperren Bots, die ihre Gateway- und REST-Rate-Limits überschreiten. **Square Shield** sitzt zwischen deinem Bot und diesen APIs und überwacht Anfragemuster, um dich innerhalb des erlaubten Budgets zu halten — der Unterschied zwischen einem Bot, der sauber skaliert, und einem, der im ungünstigsten Moment in einen Cooldown offline geht.

### Betrieb mit voller Transparenz

<AccordionGroup>
  <Accordion title="Ein-Klick-Snapshots">
    Wiederherstellungspunkte lassen dich einen fehlerhaften Deploy in Sekunden zurücksetzen — kein Datenverlust, keine Ausfallzeit. Pro- und Enterprise-Pläne ergänzen dies um automatische tägliche Snapshots.
  </Accordion>

  <Accordion title="Echtzeit-Logs">
    Streame stdout/stderr deiner Anwendung live, um in der Produktion in dem Moment zu debuggen, in dem etwas schiefläuft, ohne erneut zu deployen.
  </Accordion>

  <Accordion title="Live-Analytics">
    Verfolge CPU-, RAM- und Netzwerkverbrauch in Echtzeit über ein intuitives Panel, damit du Ressourcen richtig dimensionieren und Regressionen erkennen kannst, bevor es deine Nutzer tun.
  </Accordion>
</AccordionGroup>

### Entwicklungstools

Um deinen Workflow zu optimieren, bieten wir ein vollständiges Ökosystem von Tools:

<Steps>
  <Step title="Square Cloud CLI">
    Verwalte deine Anwendungen direkt vom Terminal aus. Deploye, prüfe Logs und vieles mehr, schnell und praktisch.

    ```bash theme={null}
    npm install -g @squarecloud/cli
    squarecloud auth login
    ```
  </Step>

  <Step title="VSCode-Erweiterung">
    Integriere die Hosting-Verwaltung in deinen bevorzugten Code-Editor und vereinfache so den Entwicklungs- und Deployment-Prozess.
  </Step>

  <Step title="GitHub Actions">
    Automatisiere das Continuous Deployment (CI/CD) deines Bots. Mit jedem `push` in dein Repository wird deine Anwendung automatisch auf unserer Plattform aktualisiert.
  </Step>
</Steps>

<Warning>
  **Achtung:** Um das Deployment über GitHub Actions zu nutzen, musst du einen API-`token` in deinen Repository-Secrets konfigurieren. Sieh dir unsere spezifische Dokumentation für die Schritt-für-Schritt-Anleitung an.
</Warning>

## Wie hoste ich meinen Bot?

<Steps>
  <Step title="Konfigurationsdatei" icon="file">
    Der erste Schritt, um deinen Bot auf **Square Cloud** zu hosten, ist das Erstellen einer detaillierten Konfigurationsdatei. Diese Datei ist nicht nur ein einfaches Textdokument, sondern ein umfassender Leitfaden, der die Einstellungen für die Anwendung auf **Square Cloud** definiert. Sie fungiert als architektonischer Bauplan für dein Projekt auf der Plattform.

    Sobald du den Plan erworben hast, musst du diese Datei erstellen, jede Konfiguration ausführlich beschreiben und sie korrekt ausfüllen. Details zum Erstellen dieser Datei findest du [hier](https://docs.squarecloud.app/de/getting-started/config-file), mit einer Schritt-für-Schritt-Anleitung.
  </Step>

  <Step title="Erstellen der ZIP-Datei" icon="file-zip">
    Wenn die Konfigurationsdatei fertig ist, besteht der nächste Schritt darin, deine Anwendung für den Upload vorzubereiten. Dazu gehört, die Anwendungsdateien und die **Square Cloud**-Konfigurationsdatei in eine .zip-Datei zu packen.

    Allerdings müssen nicht alle Dateien in diese .zip aufgenommen werden. Dateien wie `node_modules`, `package-lock.json`, `pyproject.toml` und `poetry.lock` sind nicht notwendig, da sie serverseitig automatisch generiert werden können.
  </Step>

  <Step title="Abhängigkeitsdatei" icon="box">
    Ein weiterer entscheidender Aspekt ist das Einbeziehen der Abhängigkeitsdatei in die .zip. Diese Datei teilt der **Square Cloud**-Plattform mit, welche Abhängigkeiten für dein Projekt installiert werden sollen. Für ein Node.js-Projekt ist diese Datei `package.json`, und für ein Python-Projekt ist es `requirements.txt`.

    Diese Dateien listen die Bibliotheken und Pakete auf, die für das korrekte Funktionieren der Anwendung notwendig sind. Diese Dateien aktuell zu halten ist entscheidend, um Installationsfehler zu vermeiden. Außerdem ist es wichtig zu beachten, dass native Abhängigkeiten wie `node-fetch` in Node.js und `random` in Python nicht in diese Dateien aufgenommen werden sollten, da es sich um native Bibliotheken handelt.
  </Step>

  <Step title="Bot-Upload" icon="arrow-up">
    Nachdem du alle Schritte befolgt und dein Projekt für **Square Cloud** konfiguriert hast, ist es Zeit, deinen Bot hochzuladen. Rufe die Upload-Seite auf der **Square Cloud**-Website auf und sende deine .zip-Datei [hier](https://squarecloud.app/de/dashboard/new).

    Der Prozess ist einfach: Wähle deine .zip-Datei aus und klicke auf die Upload-Schaltfläche. Die **Square Cloud**-Plattform startet den Deployment-Prozess, installiert die notwendigen Abhängigkeiten und konfiguriert die Umgebung basierend auf der Konfigurationsdatei.

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