# Umzug auf einen neuen Server

> SOLECTRUS auf einen anderen Server umziehen, indem das Installationsverzeichnis mit Konfiguration und Datenbanken kopiert wird.

Bei einem Umzug sollen keine Messwerte verloren gehen. Der sicherste Weg ist, die gesamte Installation zu kopieren. SOLECTRUS liegt in einem einzigen Verzeichnis, das alles enthält: Konfiguration, Datenbanken und die Daten von [HELIOS](/docs/referenz/helios/).

> **Das geht nur im Terminal**
>
>
> Ein Umzug ist eine der wenigen Aufgaben, für die HELIOS nichts anbietet. Die Dateien müssen von Hand vom einen Server auf den anderen kopiert werden.
>

## 1. Container stoppen

Auf dem alten Server, im Verzeichnis mit der `compose.yaml`:

```bash
docker compose down
```

Das ist wichtig für die Datenkonsistenz. Während des Kopierens dürfen die Datenbanken nicht verändert werden.

## 2. Verzeichnis kopieren

Das komplette Verzeichnis kommt auf den neuen Server, z.B. mit `rsync`:

```bash
sudo rsync -a --rsync-path="sudo rsync" /pfad/zu/solectrus/ neuer-server:/pfad/zu/solectrus/
```

Die Datenbank-Ordner gehören root. Das vordere `sudo` liest sie deshalb auf dem alten Server, das hintere (`--rsync-path`) schreibt sie auf dem neuen Server mit root-Rechten. Erst damit kann die Option `-a` Besitzer und Rechte erhalten, ohne die starten die Datenbanken auf dem neuen Server nicht.

Fragt `sudo` auf dem neuen Server nach einem Passwort, bricht rsync ab. Dann hilft die Anmeldung direkt als root, also `root@neuer-server`.

> **Abweichende Speicherorte**
>
>
> Standardmäßig liegen die Datenbanken innerhalb des Installationsverzeichnisses. Wo sie tatsächlich liegen, zeigt HELIOS unter _Konfiguration → Grundeinstellungen → Speicherorte_ an (Variablen `INFLUX_VOLUME_PATH` und `DB_VOLUME_PATH`). Liegen sie außerhalb, etwa aus einer übernommenen Installation, gehören diese Verzeichnisse ebenfalls mit auf den neuen Server.
>

## 3. Auf dem neuen Server starten

Docker muss vorhanden sein. Fehlt es, hilft das [Installationsskript](/docs/referenz/helios/#helios-installieren), ausgeführt im kopierten Verzeichnis: Es erkennt die bestehende Installation und ergänzt nur, was fehlt, Docker eingeschlossen.

Dann im kopierten Verzeichnis:

```bash
docker compose up -d
```

SOLECTRUS ist nun unter der neuen IP-Adresse erreichbar, HELIOS wie gewohnt unter Port 3999. Die Messwerte bleiben erhalten, die Konfiguration ebenso.

Auch die Registrierung und ein etwaiges Sponsoring gelten weiter, denn es entsteht keine neue Instanz. Es zieht dieselbe um.

## 4. Adresse anpassen

Hat der neue Server eine andere Adresse, gehört sie in HELIOS unter _Konfiguration → Grundeinstellungen → Host_ eingetragen. Anschließend das Dashboard unter _Dienste_ aktualisieren. Ohne diesen Schritt zeigt SOLECTRUS weiterhin auf die alte Adresse.

> **Hinweis**
>
>
> Die [Datensicherung](/docs/anleitungen/datensicherung/) ist für einen Umzug nicht der ideale Weg. Zwar lässt sich eine Sicherung auf dem neuen Server hochladen und einspielen. Das Kopieren des Verzeichnisses ist aber einfacher, denn es überträgt die Installation im Ganzen, ohne den Umweg über Archiv und Wiederherstellung.
>