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

# Deployments

> Track every build live, cancel running deployments, and roll back when needed.

Every publication is a **deployment** (Bereitstellung). Havic shows each run live, keeps
the history, and supports cancelling and rolling back.

## The deployment history

Each website has a list of all deployments with their **status**, the triggering source,
and the time. A deployment is triggered by:

* **Manuell durch *Name*** (Manually by *name*) — an upload through the interface
* **GitLab-Pipeline** — automatically from your repository
* **Rollback von Bereitstellung #N** — resetting to an earlier release

## Live progress

During a run, Havic shows the current **phase** and a **live log**:

`Empfang → Auspacken → Build → Migration → Port → Release → Health → Fertig`
(Receive → Unpack → Build → Migration → Port → Release → Health → Done)

<Note>
  For connected repositories, the phases **„Pipeline prüfen"** (Check pipeline) and
  **„Artefakt laden"** (Load artifact) are added. The live log is reserved for
  administrators.
</Note>

## Cancel or keep running in the background

While a deployment runs, **„Abbrechen"** (Cancel) gives you two options:

<CardGroup cols={2}>
  <Card title="Keep running in the background" icon="window-restore">
    The build keeps going — you follow it via a **floating card** and keep working in
    the meantime.
  </Card>

  <Card title="Cancel the deployment" icon="circle-stop">
    The build is stopped and this run is discarded. Status changes to
    **Abgebrochen** (Cancelled).
  </Card>
</CardGroup>

## Roll back

If a new version isn't right, use **„Zurückrollen"** (Roll back) to return to the
previous release.

<Warning>
  Rollback is available only for **Live** deployments. The symlink is reset to the
  previous release — you confirm beforehand.
</Warning>

## Status overview

| Status (DE)        | English     | Meaning                                           |
| ------------------ | ----------- | ------------------------------------------------- |
| **Wartet**         | Pending     | Queued, build not started.                        |
| **Läuft**          | Running     | Currently building and publishing.                |
| **Live**           | Live        | Successfully published and reachable.             |
| **Fehlgeschlagen** | Failed      | Build or health check failed — see the build log. |
| **Zurückgerollt**  | Rolled back | Reset to an earlier release.                      |
| **Abgebrochen**    | Cancelled   | Stopped during the run.                           |
| **Entfernt**       | Removed     | Taken out of service.                             |

<Tip>
  If a build fails, Havic shows the last log lines directly and offers **„Erneut
  versuchen"** (Try again). The full build log can be opened and copied.
</Tip>