# Support

> Support zu SOLECTRUS läuft über GitHub, per Issue oder Diskussion. Was einer Anfrage beizulegen ist und was im Support-Paket von HELIOS steckt.

Diese Dokumentation enthält neben der [Referenz](/docs/referenz/) zu den einzelnen Komponenten auch [Anleitungen](/docs/anleitungen/) zu häufigen Aufgaben und Problemen.

Hilft das nicht weiter, läuft der Support über **GitHub**:

- Bei technischen Problemen und Fehlerberichten ist ein **Issue** anzulegen: \
  [https://github.com/solectrus/solectrus/issues](https://github.com/solectrus/solectrus/issues)

- Für alles andere, etwa Fragen zur Installation, Verbesserungsvorschläge oder Kritik, steht der **Diskussionsbereich** zur Verfügung: \
  [https://github.com/solectrus/solectrus/discussions](https://github.com/solectrus/solectrus/discussions)

Die Suchfunktion von GitHub findet bestehende Issues und Diskussionen. Oft ist eine Frage dort schon beantwortet.

## Was mitzuschicken ist

Je mehr über die Installation bekannt ist, desto schneller lässt sich helfen. Dafür gibt es das **Support-Paket**, das [HELIOS](/docs/referenz/helios/) unter _Support_ auf Knopfdruck erzeugt: ein ZIP-Archiv mit den Protokollen der Dienste, der Konfiguration und einer Momentaufnahme des Systems.

Passwörter und Tokens ersetzt HELIOS dabei durch Platzhalter.

> **Was im Paket erhalten bleibt**
>
>
> Zwei Dinge werden nur abgeschwächt, nicht entfernt:
>
> - **Koordinaten** behalten ihre Vorkommastellen, die Nachkommastellen werden genullt (`52.51627` wird zu `52.00000`). Der Standort bleibt damit auf rund 100 km eingrenzbar.
> - **Hostnamen** maskiert HELIOS nur, wenn sie öffentlich erreichbar sind. Private IP-Adressen und Namen wie `.local` oder `.fritz.box` bleiben lesbar, damit sich die Netzwerkstruktur nachvollziehen lässt.
>
> Vor dem Anhängen in einem öffentlichen Issue lohnt sich deshalb ein Blick ins Archiv.
>

Genügt ein Ausschnitt, reicht der passende Teil aus dem [Protokoll](/docs/anleitungen/logging/) des betroffenen Dienstes.

> **Keine Support-Anfragen per E-Mail**
>
>
> Support läuft ausschließlich über GitHub. Dort bleiben Frage und Antwort für die Nächsten lesbar, die auf dasselbe Problem stoßen.
>
> Ein GitHub-Konto lässt sich kostenlos anlegen.
>