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

# Laravel Cloud Hibernation (automatisches Pausieren)

> Funktionsweise, Aktivierung, Einschränkungen sowie das Vermeiden unnötiger Aufwach-Vorgänge per Path Blocking beim Hibernation-Feature von Laravel Cloud.

## Was ist Hibernation?

**Hibernation (automatisches Pausieren)** von Laravel Cloud ist die frühere Funktion, mit der eine Umgebung nach einer bestimmten Zeit ohne HTTP-Anfragen in den Ruhezustand versetzt wird.\
In der neuen Flex Compute wird stattdessen das schnellere **Scale to Zero** als Nachfolger eingesetzt.

Hibernation in Legacy Flex stoppt zwar die Abrechnung für Compute während der Ruhe, das Aufwachen nach einer HTTP-Anfrage dauert jedoch typischerweise 5–20 Sekunden. Bei Scale to Zero verkürzt sich die Startzeit auf **unter 500 ms**; zudem startet die Umgebung während der Schlafphase automatisch für geplante Aufgaben und Queue-Verarbeitung.

<Warning>
  Wenn Sie Laravel Cloud neu einsetzen, planen Sie sicherheitshalber mit **Scale to Zero** und nicht mit Hibernation. Ein Gesamtüberblick inklusive Managed Queues und der neuen Preispläne findet sich in [Laravel Cloud – Der Gesamtüberblick zum Laravel-eigenen PaaS](/de/blog/laravel-cloud).
</Warning>

```mermaid theme={null}
sequenceDiagram
    participant User as Benutzer
    participant Cloud as Laravel Cloud
    participant App as App

    User->>Cloud: Keine Requests (Timeout)
    Cloud->>App: Wechsel in den Ruhezustand<br>(Abrechnung gestoppt)
    User->>Cloud: HTTP-Request
    Cloud->>App: Aufwachen in 5–20 s
    App-->>User: Response
```

## Was sich mit Scale to Zero geändert hat

Bei Scale to Zero der neuen Flex Compute sind die früheren Schwächen der Hibernation weitgehend gelöst.

| Aspekt                     | Alte Hibernation                            | Neue Scale to Zero                                                 |
| -------------------------- | ------------------------------------------- | ------------------------------------------------------------------ |
| Aufwachen bei HTTP-Request | 5–20 Sekunden                               | unter 500 ms                                                       |
| Scheduled Tasks            | laufen im Ruhezustand nicht                 | starten während des Sleeps automatisch und laufen                  |
| Queue-Verarbeitung         | läuft im Ruhezustand nicht                  | startet auch im Sleep automatisch. Managed Queues werden empfohlen |
| Empfohlener Einsatz        | sparender Betrieb in Legacy-Flex-Umgebungen | aktuelle Standardkonfiguration                                     |

<Info>
  Bei der bisherigen Hibernation liefen im Ruhezustand weder Task Scheduler noch Queues. Bei Scale to Zero ist dieses Problem behoben; insbesondere die Queue-Verarbeitung lässt sich mit Managed Queues sicher fortführen, selbst wenn der App Cluster schläft.
</Info>

## Aktivierung der alten Hibernation

<Steps>
  <Step title="App Compute Cluster öffnen">
    Klicken Sie im Infrastruktur-Canvas-Dashboard der Umgebung auf den App Compute Cluster.
  </Step>

  <Step title="Hibernation aktivieren">
    Schalten Sie den Toggle **Hibernation** ein.
  </Step>

  <Step title="Speichern und erneut deployen">
    Klicken Sie auf **Save and Redeploy**, um die Änderungen zu übernehmen.

    <Warning>
      Reine Konfigurationsänderungen werden nicht wirksam. Ein „Save and Redeploy" ist zwingend erforderlich.
    </Warning>
  </Step>
</Steps>

<Tip>
  Um es in der aktuellen Umgebung neu zu aktivieren, verwenden Sie den Toggle **Scale to Zero** am App Compute Cluster. Die folgenden Einschränkungen beziehen sich vor allem auf die alte Hibernation / Legacy Flex.
</Tip>

## Einschränkungen im Ruhezustand der alten Hibernation

Solange Hibernation aktiv und die Umgebung pausiert ist, funktionieren folgende Funktionen nicht:

| Funktion                       | Verhalten im Ruhezustand                           |
| ------------------------------ | -------------------------------------------------- |
| Verarbeitung von HTTP-Requests | gestoppt (Verarbeitung erfolgt nach dem Aufwachen) |
| Task Scheduler                 | wird nicht ausgeführt                              |
| Queue Worker                   | wird nicht ausgeführt                              |
| Eigene Hintergrundprozesse     | werden nicht ausgeführt                            |

<Info>
  Beim Aufwachen aus dem Ruhezustand werden diese Vorgänge automatisch fortgesetzt. Jobs, deren geplante Ausführung in die Ruhephase fiel, werden allerdings nicht rückwirkend ausgeführt.
</Info>

Für Hibernation gelten außerdem folgende Einschränkungen:

* Pausieren ist **nur mit Flex Compute** möglich. Bei Pro Compute lässt sich Hibernation nicht aktivieren.
* Das Pausieren erfolgt **pro Umgebung**. Wenn der App Cluster pausiert, werden auch alle Worker Cluster derselben Umgebung pausiert.

## Ursachen unnötiger Aufwach-Vorgänge

Die Umgebung wacht bei HTTP-Anfragen automatisch auf; auch ungewollte Requests lösen jedoch Aufwach-Vorgänge aus.

* **Bots und Crawler** – Suchmaschinen und Security-Scanner crawlen Seiten automatisch
* **Link-Vorschauen in Slack oder Teams** – Messaging-Apps rufen für Thumbnails die verlinkten Seiten ab
* **WordPress-Scans** – automatisierte Scans nach WordPress-Umgebungen greifen auf `/wp-admin` u. a. zu
* **Angriffe auf `.php`-Dateien** – automatisierte Scans, die gezielt PHP-Dateien anfragen

Auf die `*.laravel.cloud`-Domain wird der Header `X-Robots-Tag: noindex, nofollow` gesetzt, um eine Indexierung in Suchmaschinen zu verhindern; ist die Domain erst einmal entdeckt, hilft dies aber nicht mehr. Für eigene Domains wird der `noindex`-Header nicht gesetzt.

<Tip>
  Verwenden Sie möglichst komplexe Domainnamen, um das Risiko zu verringern, dass Bots Ihre Vanity-Domain finden.
</Tip>

## Unerwünschte Aufwach-Vorgänge mit Path Blocking verhindern

**Path Blocking** ist ein Feature, das Anfragen an bestimmte Dateiendungen oder Pfade im Ruhezustand blockiert, ohne die Anwendung zu wecken. Es verhindert unnötige Aufwach-Vorgänge durch WordPress-Scans und Angriffe auf PHP-Dateien.

Standardmäßig werden folgende Endungen und Pfade blockiert:

**Blockierte Dateiendungen:**

```
.php, .php3, .php4, .php5, .php6, .php7, .php8,
.phtml, .pht, .phps, .env, .git
```

**Blockierte Pfade:**

```
/wp-admin, /wp-content, /wp-includes, /wp-json
```

Diese Anfragen werden beantwortet, ohne die App aus dem Ruhezustand zu holen.

<Info>
  Im normalen Routing von Laravel werden keine Anfragen mit `.php`-Endung verwendet, sodass das Blockieren dieser Endungen die Anwendung nicht beeinträchtigt.
</Info>

## Wann alte Hibernation passt und wann nicht

<Columns cols={2}>
  <Card title="Passende Einsatzfälle" icon="check">
    * **Staging- und Entwicklungsumgebungen** – kein Dauerbetrieb nötig, deutliche Kostenersparnis
    * **Persönliche Blogs und Portfolios** – geringer Traffic
    * **Demos und Test-Apps** – Aufwachen nur bei Bedarf ausreichend
    * **Selten genutzte interne Tools** – begrenzte Nutzungsfenster
  </Card>

  <Card title="Ungeeignete Einsatzfälle" icon="xmark">
    * **Anwendungen mit Task Scheduling** – `schedule:run` läuft im Ruhezustand nicht
    * **Anwendungen mit periodischen Queue-Jobs** – Queues stehen im Ruhezustand still
    * **Produktion mit inakzeptabler Startlatenz** – Aufwachen dauert 5–20 s
    * **Anwendungen mit WebSockets** – Verbindungen lassen sich schwer halten, Pause kann verzögert werden
  </Card>
</Columns>

<Warning>
  Wenn Sie regelmäßig laufende Aufgaben per Task Scheduler benötigen (E-Mail-Versand, Datenaggregation usw.), werden diese bei aktivierter Hibernation nicht ausgeführt. In solchen Fällen sollten Sie Hibernation deaktivieren oder ein Design wählen, bei dem ein externer Scheduler (z. B. GitHub Actions) Anfragen schickt, um die Umgebung wach zu halten.
</Warning>

<Info>
  Bei Scale to Zero ist diese Einschränkung entschärft. Scheduled Tasks laufen auch im Sleep automatisch, und die Queue-Verarbeitung ist mit Managed Queues unabhängig vom Ruhezustand des App Clusters.
</Info>

## Fazit

Hibernation lässt sich in Legacy Flex weiterhin für Kostenreduktion einsetzen, praxistauglicher ist heute jedoch Scale to Zero.

* In Legacy Flex wird nur die Betriebszeit abgerechnet. Nach dem Timeout erfolgt automatisches Pausieren.
* Die Aufwachzeit der alten Hibernation liegt bei 5–20 Sekunden.
* Die neue Scale to Zero startet in unter 500 ms.
* Bei Scale to Zero laufen Scheduled Tasks und Managed Queues auch im Sleep.
* Path Blocking verhindert unnötige Aufwach-Vorgänge durch Bots.
* Nur mit Flex Compute möglich.

## Verwandte Seiten

<Columns cols={2}>
  <Card title="Scheduling" icon="calendar" href="/de/scheduling">
    Konfiguration des Task Schedulers und das Verhalten in Laravel Cloud.
  </Card>

  <Card title="Queues" icon="list" href="/de/queues">
    Konfiguration von Queue Workern und Betrieb in Laravel Cloud.
  </Card>

  <Card title="Laravel Cloud – Überblick" icon="cloud" href="/de/blog/laravel-cloud">
    Managed Queues, Scale to Zero und die neuen Preispläne zusammengefasst.
  </Card>
</Columns>


## Related topics

- [Laravel Cloud – Der Gesamtüberblick zum Laravel-eigenen PaaS](/de/blog/laravel-cloud.md)
- [laravel/symfony-on-cloud – Symfony-Apps auf Laravel Cloud betreiben](/de/blog/symfony-on-cloud-introduction.md)
- [Laravel Octane](/de/octane.md)
- [WebSocket (Jetstream / Firehose)](/de/packages/laravel-bluesky/websocket.md)
- [Deployment](/de/deployment.md)