# Häufige Fragen

> Kurze Antworten auf die Fragen, die am häufigsten zu Pithyx gestellt werden, mit Schnellsuche.

Source: https://pithyx.org/de/docs/faq/
Markdown: https://pithyx.org/de/docs/faq.md

Tipp, um die Fragen zu filtern, oder wähl eine Kategorie. Jede Frage ist eine Datei in `website/src/content/faq/`.

## Ist Pithyx kostenlos?

Ja. Das System ist freie Software unter der AGPL-3.0, die npm-Pakete für App-Entwickler (`@pithyx/sdk`, `@pithyx/ui`, `@pithyx/cli`) stehen unter MIT. Es gibt keine kostenpflichtige Edition und keine Funktion, die ein Konto braucht.

Details: [Lizenz](/de/docs/project/license/).

## Darf ich Pithyx forken oder unter einem anderen Namen weitergeben?

Ja, unter der GNU AGPL-3.0 mit den Bedingungen in `NOTICE`. Ein Fork oder eine Weitergabe behält die Urheberangabe „Based on Pithyx (https://github.com/pithyx/pithyx), originally created by Schecher1 (https://github.com/Schecher1), licensed under the GNU AGPL-3.0.“ in `NOTICE`, überall, wo sie im Quellcode und in der Dokumentation steht, und auf der About-Seite. Eine geänderte Version muss einen eigenen Produktnamen (nicht Pithyx) verwenden, darf das Pithyx-Logo nicht nutzen und sich nicht als Pithyx ausgeben. Apps, die mit den npm-Paketen unter MIT gebaut sind, betrifft das nicht.

Details: [Lizenz](/de/docs/project/license/#urheberangabe-in-forks-und-weitergaben).

## Kann ich meine wichtigen Daten schon auf Pithyx speichern?

Ja, mit einer Sicherung. Pithyx 1.0 ist als Beta gekennzeichnet: Wir halten es für stabil, aber es hat sich noch nicht im Alltag auf echten Boxen bewährt. Behandle es als Beta und halte von allem Wichtigen eine Kopie auf einem anderen Gerät. Pools sind noch nicht verschlüsselt.

Details: [Was ist Pithyx](/de/docs/getting-started/what-is-pithyx/).

## Braucht Pithyx eine Internetverbindung?

Nein. Installer, Desktop, Speicher und Dateifreigaben funktionieren ohne Internet. Nur der Store holt seine Kataloge und die Container-Images von Katalog-Apps aus dem Internet, und die Uhr nutzt öffentliche Zeitserver, solange du keine eigenen einträgst.

Details: [Sicherheit](/de/docs/admin/security/).

## Gibt es eine App fürs Handy?

Eine eigene Handy-App gibt es nicht. Der Web-Desktop passt sich dem Bildschirm an: Auf dem Handy füllt jede App den Bildschirm, auf dem Tablet sind Fenster maximiert. Für Dateien kann sich jede App verbinden, die SMB 3, SFTP, WebDAV oder FTP mit TLS spricht.

Details: [Der Desktop](/de/docs/user/desktop/).

## Kann ein KI-Assistent diese Doku lesen?

Ja. `/de/llms.txt` listet jede Seite, `/de/llms/<bereich>.txt` bündelt einen Bereich und `/de/llms-full.txt` enthält alles, jeweils als reines Markdown. Jede Seite gibt es außerdem als Markdown, wenn du `.md` an ihre Adresse hängst.

Details: [Übersicht der Doku](/de/docs/).

## Wie spricht man Pithyx aus, und woher kommt der Name?

/ˈpɪθɪks/, „PITH-iks“. Pandora hat nie eine Büchse geöffnet: Sie öffnete einen Pithos (πίθος), ein großes Vorratsgefäß des antiken Griechenlands, das Erasmus von Rotterdam später falsch mit Pyxis, Büchse, übersetzte. Was darin blieb, war die Hoffnung. Pithyx bewahrt, was zählt, auf deiner Hardware. Der Stamm ist Pithos; die Endung -yx ist eine Stilisierung nach griechischen Vorbildern wie Onyx und Styx.

## Welche Hardware brauche ich?

Einen 64-Bit-x86-Rechner (x86-64-v2 oder neuer) mit UEFI, mindestens 2 GB Arbeitsspeicher (empfohlen 4 GB oder mehr) und eine interne Systemplatte mit mindestens 32 GB. Der Installer prüft das alles, bevor er startet. Referenz ist ein Intel N100 oder N305 mit 8 GB Arbeitsspeicher.

Details: [Hardware-Anforderungen](/de/docs/getting-started/requirements/).

## Brauche ich mehr als eine Festplatte?

Ja, für deine Daten. Das System kommt auf eine Platte oder gespiegelt auf zwei, und Pithyx legt nie einen Pool auf der Systemplatte an. Deine Dateien liegen auf Pools, die du in der App Speicher auf weiteren Platten anlegst.

Details: [Hardware-Anforderungen](/de/docs/getting-started/requirements/).

## Läuft Pithyx auf einem Raspberry Pi oder einem anderen ARM-Board?

Nein. Image und Installer gibt es nur für 64-Bit-x86. Ein arm64-Image und eine 32-Bit-Version gibt es nicht.

Details: [Hardware-Anforderungen](/de/docs/getting-started/requirements/).

## Kann ich das System auf einen USB-Stick oder eine SD-Karte installieren?

Ja, wenn er mindestens 32 GB hat, aber der Installer warnt dich, und du entscheidest. Das System schreibt ständig Logs und seine Datenbank auf die Systemplatte, und ein billiger USB-Stick oder eine Speicherkarte ist nach wenigen Monaten kaputt. Wenn du so etwas nimmst, dann eine USB-SSD oder einen schnellen USB-3-Stick eines bekannten Herstellers (bei einer Karte eine für den Dauerbetrieb), am besten zwei als Spiegel, und halte eine Konfigurationssicherung bereit. Eingebauter eMMC-Speicher, wie in vielen kleinen Computern, zählt als interne Festplatte und bekommt keine Warnung. Eine Festplatte geht auch; der Installer weist darauf hin, dass eine SSD schneller, leiser und sparsamer ist.

Details: [Hardware-Anforderungen](/de/docs/getting-started/requirements/).

## Funktioniert WLAN?

Nein. Pithyx unterstützt nur kabelgebundene Netzwerkkarten. Schließ die Box mit einem Netzwerkkabel an.

Details: [Hardware-Anforderungen](/de/docs/getting-started/requirements/).

## Kann ich Pithyx in einer virtuellen Maschine betreiben?

Der Installer wird in virtuellen Maschinen mit QEMU, KVM und UEFI-Firmware getestet, das Image hängt dabei als USB-Stick an. Andere Hypervisoren, der Start als virtuelle CD und eine Bandbreite echter Hardware sind nicht getestet. Die VM braucht UEFI mit ausgeschaltetem Secure Boot und eigene virtuelle Platten für Pools.

Details: [Hardware-Anforderungen](/de/docs/getting-started/requirements/).

## Wo lade ich Pithyx herunter?

Von den [Releases auf GitHub](https://github.com/pithyx/pithyx/releases). Der Installer ist eine einzelne Image-Datei, `pithyx-<version>-amd64.iso`, daneben liegt die Prüfsummendatei `.sha256`; du schreibst das Image als ganzes Disk-Image auf einen USB-Stick. Das Image trägt keine Signatur, die Prüfsumme zeigt also nur, dass der Download vollständig ist.

Details: [USB-Stick schreiben](/de/docs/install/usb-stick/).

## Funktioniert Pithyx mit Secure Boot oder Legacy-BIOS?

Nein. Pithyx startet nur im UEFI-Modus, und Secure Boot muss aus sein, weil das ZFS-Modul nicht signiert ist. Die erste Seite des Installers prüft beides und sagt dir, was du in den Firmware-Einstellungen ändern musst.

Details: [Firmware und Boot](/de/docs/install/firmware-and-boot/).

## Wie finde ich die Adresse meiner Box?

Die Konsole der Box zeigt ihre Adresse an, zum Beispiel `https://192.168.1.50:7484` (`http://`, während der Installer läuft, mit einem QR-Code). Die Box kündigt keinen Namen im Netzwerk an; ohne Bildschirm suchst du ihre Adresse in der DHCP-Liste deines Routers. Sagt die Konsole, dass sie auf eine Netzwerkadresse wartet, prüf das Netzwerkkabel.

Details: [Firmware und Boot](/de/docs/install/firmware-and-boot/).

## Warum sagt der Installer "Installation läuft woanders"?

Der erste Browser, der den Installer öffnet, übernimmt die Installation; jeder andere Browser sieht **Installation läuft woanders**, und die Konsole nennt die Adresse, der sie gehört. Mach in diesem Browser weiter. Um neu anzufangen, starte den Rechner erneut vom Stick.

Details: [Der Web-Installer](/de/docs/install/installer/).

## Muss der USB-Stick nach der Installation drinbleiben?

Nein. Das installierte System schreibt seinen Bootloader auf jede Systemplatte und legt einen Booteintrag an, die Box startet also auch mit eingestecktem Stick von ihrer Platte. Der Installer bittet dich trotzdem, den Stick vor dem Neustart zu entfernen.

Details: [Firmware und Boot](/de/docs/install/firmware-and-boot/).

## Kann ich mein bestehendes NAS-System übernehmen?

Pithyx wird nur frisch installiert und übernimmt keine Konfiguration anderer Systeme. Vorhandene ZFS-Pools kannst du nach der Installation in der App Speicher importieren, zuerst schreibgeschützt, damit du sie prüfen kannst.

Details: [Speicher und Pools](/de/docs/admin/storage/).

## Löscht eine Neuinstallation meine Daten?

Nicht, wenn du nur die Systemplatten auswählst: Der Installer löscht die gewählten Platten und sonst nichts. Danach importierst du deine Pools in Speicher mit **Pool importieren…** (nach einer Neuinstallation ist ein erzwungener Import normal) und spielst in Einstellungen > **Backup und Wiederherstellung** ein Konfigurations-Backup ein. Beides macht der Installer nicht für dich.

Details: [Wiederherstellen und neu installieren](/de/docs/install/recovery/).

## Mein Pool fehlt nach dem Neustart. Was tun?

Ein Pool, den du angelegt oder zur Nutzung importiert hast, kommt bei jedem Start wieder, solange seine Platten da sind. Fehlt er oder zeigt er fehlende Platten, prüf Kabel und Strom der Platten und starte neu; Freigaben und Apps darauf bleiben bis dahin nicht verfügbar. Ein Pool, den du nur schreibgeschützt zur Vorschau importiert hast, bleibt nicht erhalten, und nach einer Neuinstallation kennt die Box deine Pools nicht: Importier sie in Speicher mit **Pool importieren…**.

Details: [Speicher und Pools](/de/docs/admin/storage/).

## Warum ist meine Platte "Nicht verfügbar" oder will ihre Seriennummer?

Eine Platte ist **Nicht verfügbar**, wenn sie das System enthält, schon in einem Pool steckt, schreibgeschützt oder in Benutzung ist, ihre Seriennummer mit einer anderen Platte teilt oder Daten, aber keine Seriennummer hat; die App Speicher zeigt den Grund. Eine Platte mit Partitionen oder Daten braucht **Bestätigung nötig**: Tipp ihre Seriennummer ein, um sie zu nutzen, und alles darauf wird gelöscht.

Details: [Speicher und Pools](/de/docs/admin/storage/).

## Kann ich einen Pool verschlüsseln?

In dieser Version nicht. Der Pool-Assistent lehnt **Mit einem Schlüssel verschlüsseln** ab, wähl also **Keine Verschlüsselung**. Nachträglich lässt sich ein Pool nicht verschlüsseln.

Details: [Speicher und Pools](/de/docs/admin/storage/).

## Kann ich einem Pool später Platten hinzufügen?

Ja, auf zwei Wegen: **Platten hinzufügen…** fügt dem Pool eine neue Plattengruppe hinzu, **Um eine Platte erweitern…** verbreitert eine RAID-Z-Gruppe um eine Platte. Beides lässt sich nicht rückgängig machen. Eine Einzelplatte nachträglich zum Spiegel machen kann die App Speicher nicht.

Details: [Speicher und Pools](/de/docs/admin/storage/).

## Eine Platte in meinem Pool ist ausgefallen. Was mache ich?

Administratoren bekommen eine Benachrichtigung, und ein Pool mit Redundanz läuft im Zustand **Beeinträchtigt** weiter. Tausch die Platte in Speicher mit **Ersetzen…** und bestätige die Seriennummer der neuen Platte; ZFS baut die Daten dann neu auf (Resilver). Eine Platte, die von selbst zurückkommt, wird automatisch neu aufgebaut.

Details: [Speicher und Pools](/de/docs/admin/storage/).

## Weckt Pithyx meine schlafenden Platten auf?

Pithyx vermeidet es: SMART-Werte liest es nur von wachen Platten, und der Ressourcenmonitor nutzt die Zähler des Kernels. Manche Aktionen wecken Platten trotzdem: ein Scrub, **Platten durchsuchen** beim Import und das optionale Log-Archiv etwa einmal am Tag. Eine Einstellung, die Platten schlafen legt, hat Pithyx nicht.

Details: [Speicher und Pools](/de/docs/admin/storage/).

## Sind Snapshots und Wiederherstellungspunkte ein Backup?

Nein. Wiederherstellungspunkte und Snapshots liegen auf denselben Platten wie deine Dateien; sie helfen gegen versehentliches Löschen und Ransomware, aber nicht gegen einen verlorenen Pool. Das Konfigurations-Backup in den Einstellungen enthält Einstellungen und Benutzer, nicht deine Dateien. Halte eine Kopie deiner Dateien auf einem anderen Gerät.

Details: [Freigegebene Ordner](/de/docs/admin/shared-folders/).

## Wie komme ich von meinem Rechner an meine Dateien?

Über SMB, SFTP, WebDAV oder FTP, angemeldet mit deinem Pithyx-Benutzernamen und Passwort. SMB ist in einer frischen Installation an und neue Benutzer dürfen es nutzen; die anderen Dienste schaltet ein Administrator ein und gibt dir das Recht dazu. Unter Windows tippst du `\\<box-adresse>\` in den Explorer, unter macOS nimmst du `smb://<box-adresse>/`.

Details: [Von anderen Geräten zugreifen](/de/docs/user/file-access/).

## Haben Benutzer einen eigenen privaten Ordner?

Ja. Jeder Benutzer hat einen Home-Ordner, den nur er und die Administratoren öffnen können. Er heißt **home** in Dateien und über SMB, SFTP, WebDAV und FTP; Administratoren sehen zusätzlich das Home jedes Benutzers unter **homes**. Er hat seinen eigenen Papierkorb. Seinen Pool und seine Quota legen Administratoren unter Einstellungen > **Home-Ordner** fest.

Details: [Home-Ordner](/de/docs/admin/home-folders/).

## Wo ist meine gelöschte Datei hin?

In den Papierkorb ihres freigegebenen Ordners, wenn du sie in Dateien, über SMB oder über WebDAV gelöscht hast. Öffne in der Seitenleiste von Dateien den **Papierkorb** und wähl **Wiederherstellen**. Einträge bleiben dort standardmäßig 30 Tage. **Endgültig löschen** (Umschalt+Entf) umgeht den Papierkorb, und Löschen über SFTP oder FTP umgeht ihn womöglich auch.

Details: [Dateien](/de/docs/user/files/).

## Kann ich eine ältere Version einer Datei zurückholen?

Ja, wenn ein Administrator für den freigegebenen Ordner Wiederherstellungspunkte eingeschaltet hat (bei neuen Ordnern sind sie an). Klick in Dateien mit rechts auf die Datei und wähl **Frühere Versionen**; es gibt einen Punkt pro Tag für 7 Tage. Windows zeigt dieselben Punkte über SMB als Vorgängerversionen.

Details: [Dateien](/de/docs/user/files/).

## Warum haben meine Videos oder HEIC-Fotos keine Vorschau?

Dateien erzeugt Vorschaubilder nur für JPEG-, PNG-, WebP- und GIF-Bilder bis 256 MiB und 50 Millionen Pixel; andere Typen zeigen ein Symbol. Der Betrachter öffnet mehr Formate, darunter PDF, Text sowie Audio und Video, die dein Browser abspielen kann.

Details: [Dateien](/de/docs/user/files/).

## Warum taucht die Box unter Netzwerk in Windows oder im Finder nicht auf?

Pithyx kündigt sich nicht im Netzwerk an, deshalb erscheint die Box in keiner Netzwerkliste. Gib stattdessen ihre Adresse ein: `\\<box-adresse>\` im Windows-Explorer oder `smb://<box-adresse>/` unter **Mit Server verbinden** auf macOS.

Details: [Von anderen Geräten zugreifen](/de/docs/user/file-access/).

## Warum wird mein Passwort über SMB oder SFTP abgelehnt?

Meist ist es eins von drei Dingen: Deinem Konto fehlt das Recht für den Dienst, das Konto ist deaktiviert, oder der Dienst kennt dein Passwort noch nicht. Im letzten Fall meldest du dich einmal am Web-Desktop an oder bittest einen Administrator, ein neues Passwort zu setzen. Nach fünf Fehlversuchen innerhalb von fünf Minuten pausieren weitere Versuche kurz.

Details: [Von anderen Geräten zugreifen](/de/docs/user/file-access/).

## Unterstützt Pithyx NFS oder ältere SMB-Versionen?

Nein. Pithyx bietet SMB 3, SFTP, WebDAV und FTP an, ohne NFS und ohne Gastzugang, und ältere Clients, die nur SMB 1 oder 2 sprechen, können sich nicht verbinden. Für Geräte wie Scanner nimm FTP (mit TLS oder, wenn ein Administrator es erlaubt, unverschlüsselt).

Details: [Dateidienste](/de/docs/admin/file-services/).

## Ich habe mein Passwort vergessen. Was jetzt?

Bitte einen Administrator, ein neues zu setzen; einen Reset per E-Mail gibt es nicht. Ein Administrator, der sein eigenes Passwort vergessen hat, wählt auf der Anmeldeseite **Passwort vergessen?** und gibt den Wiederherstellungsschlüssel aus der Installation ein. Ohne Schlüssel und ohne weiteren Administrator hilft nur eine Neuinstallation.

Details: [Wiederherstellen und neu installieren](/de/docs/install/recovery/).

## Wie ändere ich mein Passwort?

In dieser Version können Benutzer ihr Passwort nicht selbst ändern: Ein Administrator setzt in Einstellungen > **Benutzer** mit **Neues Passwort** ein neues, das meldet dich überall ab. Ein Passwort braucht mindestens 8 Zeichen und darf nicht auf der Liste verbreiteter Passwörter stehen; Regeln für Großbuchstaben oder Sonderzeichen gibt es nicht.

Details: [Dein Konto](/de/docs/user/account/).

## Ich habe den Wiederherstellungsschlüssel verloren. Was jetzt?

Solange sich noch ein Administrator anmelden kann, ist nichts verloren, aber anzeigen lässt sich der Schlüssel nicht mehr: Die Box speichert nur einen Hash. Wer den Schlüssel benutzt, bekommt einen neuen, und das Konfigurations-Backup enthält ihn. Verlierst du den Schlüssel und alle Administrator-Passwörter, musst du das System neu installieren.

Details: [Erste Einrichtung](/de/docs/install/first-setup/).

## Ich habe mein Handy mit der Authenticator-App verloren. Wie melde ich mich an?

Wähl bei der Anmeldung **Stattdessen einen Wiederherstellungscode verwenden** und gib einen der 10 Wiederherstellungscodes ein, die du beim Einschalten der Zwei-Faktor-Anmeldung gespeichert hast; jeder gilt einmal. Ein Administrator ohne Codes kann mit dem Wiederherstellungsschlüssel zurücksetzen, das schaltet die Zwei-Faktor-Anmeldung ab. Für andere Benutzer kann die Oberfläche sie noch nicht abschalten.

Details: [Dein Konto](/de/docs/user/account/).

## Warum sieht ein neuer Benutzer einen freigegebenen Ordner oder eine App nicht?

Ein neuer Benutzer kann sich am Desktop anmelden, SMB nutzen und Dateien sowie Betrachter öffnen, sonst nichts. Gib ihm im Dialog **Rechte** Zugriff auf jeden freigegebenen Ordner, die anderen Dateidienste und die Apps, oder gib ihn einer Gruppe, in der er Mitglied ist. Ein Ordner ohne Zugriff ist unsichtbar, nicht verweigert.

Details: [Berechtigungen](/de/docs/admin/permissions/).

## Löscht das Löschen eines Benutzers auch seine Dateien?

Nur, wenn du es so wählst. Beim Löschen eines Benutzers fragt Pithyx, was mit seinem Home-Ordner passiert: behalten (die Vorgabe), seine Dateien in einen freigegebenen Ordner verschieben oder ihn löschen, nachdem du den Benutzernamen eingegeben hast. Dateien, die der Benutzer in freigegebenen Ordnern angelegt hat, bleiben immer, und seine Benutzer-ID wird nie neu vergeben. Willst du jemanden aussperren, ohne etwas zu löschen, nimm **Deaktivieren**: Das Konto verliert alle Rechte und wird abgemeldet.

Details: [Home-Ordner](/de/docs/admin/home-folders/#wenn-ein-benutzer-gelöscht-wird).

## Wie lange bleibe ich angemeldet?

Bis zu 7 Tage ohne Nutzung des Desktops und höchstens 30 Tage insgesamt. **Abmelden** beendet nur die Sitzung dieses Browsers; eine Liste deiner Sitzungen und eine Möglichkeit, andere Geräte selbst abzumelden, gibt es nicht. Setzt ein Administrator ein neues Passwort, enden alle deine Sitzungen.

Details: [Dein Konto](/de/docs/user/account/).

## Ich habe eine falsche Netzwerkadresse eingestellt und keine Verbindung mehr. Was jetzt?

Warte 60 Sekunden: Jede Netzwerkänderung geht von selbst zurück, wenn du sie nicht mit **Behalten** bestätigst. Kommst du danach immer noch nicht drauf, nimm das Konsolenmenü am Bildschirm der Box: `[r]` setzt alle Karten auf DHCP zurück, `[s]` setzt eine feste Adresse, ohne Passwort.

Details: [Netzwerk](/de/docs/admin/network/).

## Kann ich mehrere Netzwerkkarten, Bonding oder VLANs nutzen?

Ja. In Einstellungen > **Netzwerk** bekommt jede Karte eigene Einstellungen, **Bond hinzufügen** bündelt Karten (Active-Backup, LACP oder adaptive Lastverteilung) und **VLAN hinzufügen** legt ein getaggtes VLAN auf einer Karte oder einem Bond an. IPv4 und IPv6 können jeweils automatisch, statisch oder aus sein. Für WLAN und Bridges gibt es keine Einstellungen.

Details: [Netzwerk](/de/docs/admin/network/).

## Welche Ports nutzt Pithyx?

Der Web-Desktop und WebDAV nutzen Port 7484 (HTTPS); die Ports 80 und 443 leiten dorthin um, außer für Domains des eingebauten Reverse Proxys. SMB nutzt 445, SFTP 22 und FTP 21 mit den passiven Datenports 50000 bis 50099. Die Firewall der Box lässt nur die Webports, die eingeschalteten Dateidienste und die Ports der Streams des Reverse Proxys herein, und unter Einstellungen > **Dateidienste** lassen sich die Dateidienste auf private Netze begrenzen. Pithyx bietet keinen eigenen Fernzugriff; erreiche die Box von außen lieber über ein VPN, statt diese Ports in deinem Router weiterzuleiten.

Details: [Dateidienste](/de/docs/admin/file-services/).

## Kann ich die Box hinter einen Reverse Proxy stellen?

Ja. Lass den Proxy auf `https://<box-adresse>:7484` zeigen, ihm dem Root-Zertifikat der Box vertrauen (Einstellungen > **Zertifikate**) oder die Zertifikatsprüfung für dieses Backend auslassen, und WebSocket-Upgrades durchreichen. Die Box spricht nur HTTPS; die Verbindung vom Proxy kostet im lokalen Netz so gut wie nichts.

Details: [Zertifikate](/de/docs/admin/certificates/#hinter-einem-reverse-proxy).

## Kann die Box meine anderen Dienste unter eigenen Domains erreichbar machen?

Ja. Einstellungen > **Reverse Proxy** leitet Domains auf den Ports 443 und 80 an Dienste in deinem Netz oder auf der Box weiter, mit einem Zertifikat der Zertifizierungsstelle der Box oder einem hochgeladenen, auf Wunsch hinter Basic Auth oder der Pithyx-Anmeldung. Lass die Domains vorher in deinem DNS oder Router auf die Box zeigen. Streams leiten einen TCP- oder UDP-Port für Dienste weiter, die kein HTTP sprechen. Die Box selbst bleibt auf Port 7484.

Details: [Reverse Proxy](/de/docs/admin/reverse-proxy/).

## Woher kommen Apps?

Administratoren installieren sie im Store, aus dem offiziellen oder dem Community-Katalog, aus selbst hinzugefügten Katalogen oder aus einer Paketdatei (`.pithyxapp`). Der offizielle und der Community-Katalog sind signiert und werden von der Box geprüft; eigene Kataloge und Paketdateien nicht. Jede App läuft in einer Sandbox, ihr Backend, falls sie eins hat, in Containern.

Details: [Apps und der Store](/de/docs/admin/apps-and-store/).

## Ist der Community-Katalog an, und kann ich ihn ausschalten?

Ja, er ist standardmäßig an, neben dem offiziellen Katalog. Seine Apps stammen von Entwicklern außerhalb des Pithyx-Projekts; das Projekt prüft, baut und signiert sie, kann aber nicht wie für eigene Apps für sie einstehen. Willst du nur offizielle Apps sehen, öffne das Zahnrad des Stores und schalte den Community-Katalog unter **Kataloge** aus; das erneute Einschalten fragt noch einmal nach.

Details: [Kataloge und Vertrauen](/de/docs/admin/apps-and-store/#kataloge-und-vertrauen).

## Warum startet meine App nicht?

Die häufigsten Ursachen: Der Pool der App ist offline oder gesperrt ("Pool nicht verfügbar"), ihr Backend startet noch (eine Anfrage wartet bis zu 30 Sekunden), oder ein Administrator hat die App deaktiviert oder dir das Recht genommen, sie zu nutzen. Ein Administrator findet die Meldungen des Backends im Protokoll-Center unter der Quelle `app/<id>`. Ist der Zugang der App abgelaufen, schließ das Fenster und öffne die App neu.

Details: [Apps benutzen](/de/docs/user/apps/).

## Können normale Benutzer Apps installieren?

Nein. Nur Administratoren öffnen den Store und installieren Apps. Für jede App legen sie unter **Wer sie nutzen darf** fest: alle, nur Administratoren oder ausgewählte Gruppen und Benutzer. Fehlt dir eine App, frag einen Administrator.

Details: [Berechtigungen](/de/docs/admin/permissions/).

## Wo speichern Apps ihre Daten?

Auf dem App-Pool, den ein Administrator bei der ersten App-Installation wählt, in einem Dataset pro App; auch die Daten von Docker liegen auf diesem Pool, nie auf der Systemplatte. Solange eine App installiert ist, lässt sich der Pool nicht wechseln. Beim Deinstallieren fragt der Store, ob die Daten bleiben sollen, damit eine spätere Installation sie wiederfindet.

Details: [Apps und der Store](/de/docs/admin/apps-and-store/).

## Was sieht eine App von meinen Dateien und Daten?

Nur, was ihre Berechtigungen erlauben, und nie mehr, als dein eigenes Konto darf. Ohne Dateiberechtigungen sieht eine App keine Dateien; mit ihnen liest sie Dateien, die du mit ihr öffnest oder in einem Dialog auswählst, oder durchsucht die freigegebenen Ordner, die du nutzen darfst. Ohne die Berechtigung **Internet** kommt sie nicht aus der Box heraus. Ein Administrator sieht die Berechtigungen vor der Installation und kann sie abschalten.

Details: [Apps benutzen](/de/docs/user/apps/).

## Muss ich Docker einrichten, und kann ich eigene Container betreiben?

Einrichten musst du nichts: Pithyx betreibt das Docker von Debian selbst, und nur solange eine App mit Backend installiert ist. Container laufen nur als Teil einer App, aus einer geprüften Teilmenge von Compose mit per Digest festgelegten Images, in einem internen Netzwerk ohne Host-Ports. Eine allgemeine Container-Verwaltung hat Pithyx nicht, und Version 0.1 lehnt den Docker-Socket und Rechte auf dem ganzen Host ab.

Details: [Apps und der Store](/de/docs/admin/apps-and-store/).

## Wie aktualisiere ich Pithyx?

Unter Einstellungen > **Updates**. Die Box prüft ihren Kanal einmal am Tag und benachrichtigt die Administratoren; sie installiert nie von selbst. **{version} installieren** macht einen Snapshot des Systems, installiert das Update und startet neu, und kehrt von selbst zum Snapshot zurück, wenn die neue Version ihre Prüfung nicht besteht. Ohne Internet lädst du stattdessen eine `.pithyxupdate`-Datei hoch. Pools und ihre Dateien bleiben unberührt.

Details: [Systemupdates](/de/docs/install/updates/).

## Werden Apps automatisch aktualisiert, und kann ich zurück?

Das hängt von der Regel in den Store-Einstellungen ab: **Installieren**, **Administratoren benachrichtigen** (Standard) oder **Nichts tun**, standardmäßig täglich um 03:00 geprüft. Ein Update, das neue Berechtigungen will, installiert sich nie von selbst. Vor jedem Update macht Pithyx einen Snapshot, und **Zurück zu** mit der Versionsnummer bringt die vorherige Version mit ihren Daten wie vorher zurück.

Details: [Apps und der Store](/de/docs/admin/apps-and-store/).

## Schickt Pithyx Daten irgendwohin?

Nein. Pithyx hat keine Telemetrie, telefoniert nicht nach Hause und braucht kein Cloud-Konto, und Logs bleiben auf der Box. Von sich aus verbindet es sich nur, um die eingeschalteten App-Kataloge und ihre Images zu holen, um öffentliche Zeitserver zu erreichen, solange du keine eigenen einträgst, und für Apps, denen du die Berechtigung **Internet** gibst.

Details: [Datenschutz](/de/docs/project/privacy/).

## Warum sagt mein Browser, die Verbindung sei nicht sicher?

Die Box erstellt ihr eigenes Zertifikat, und dein Browser weiß noch nicht, wer es signiert hat. Verschlüsselt ist die Verbindung trotzdem. Fahre zur Seite fort, lade dann unter Einstellungen > **Zertifikate** das Root-Zertifikat der Box herunter und installiere es auf dem Gerät; danach ist die Warnung weg.

Details: [Zertifikate](/de/docs/admin/certificates/).

## Ist der Datenverkehr zu meiner Box verschlüsselt?

Ja, bei jedem Dienst außer reinem FTP. Der Web-Desktop und WebDAV nutzen HTTPS, SFTP und FTP mit TLS sind verschlüsselt, und SMB 3 ist immer signiert und verschlüsselt, wenn der Client es verlangt oder ein Administrator es für einen freigegebenen Ordner vorschreibt. Reines FTP ist aus, solange ein Administrator es nicht erlaubt. Nur das Live-System des Installers spricht reines HTTP.

Details: [Sicherheit](/de/docs/admin/security/).

## Wie schalte ich SSH ein?

SSH ist standardmäßig aus, und root bleibt gesperrt. Ein Administrator gibt dem Benutzer das Recht "Über SSH mit einer Shell anmelden" und schaltet in Einstellungen > **Dateidienste** die **SSH-Anmeldungen** ein. SFTP für Dateiübertragungen ist ein eigener Schalter und gibt keine Shell.

Details: [Sicherheit](/de/docs/admin/security/).

## Wie melde ich eine Sicherheitslücke?

Vertraulich über ein GitHub Security Advisory bei `pithyx/pithyx`, nicht in einem öffentlichen Issue. Nenn die Version oder den Commit, die Schritte zum Nachstellen und die Auswirkung, die du erwartest.

Details: [Sicherheitslücke melden](/de/docs/project/security/).

## Wie schreibe ich eine eigene App?

Bau ein statisches Web-Frontend mit `@pithyx/sdk`, leg ein Manifest `pithyx.json` und ein `icon.svg` dazu und probier es mit `pithyx dev` aus, einem Test-Desktop auf deinem eigenen Rechner. `pithyx validate` prüft es, und `pithyx pack` schreibt das Paket `.pithyxapp`, das ein Administrator installiert. Einen Entwicklungsmodus auf der Box gibt es nicht.

Details: [Deine erste App](/de/docs/developers/apps/first-app/).

## Warum funktionieren localStorage oder ein Skript von einem CDN in meiner App nicht?

Apps laufen in einem Sandbox-iframe ohne `allow-same-origin`, deshalb bringen `localStorage` und IndexedDB nichts: Speicher Daten mit `app.storage` aus dem SDK. Die Content Security Policy erlaubt Skripte nur aus der App selbst, also bündel jedes Skript und verzichte auf Inline-`<script>`; Inline-Styles sind erlaubt. `pithyx dev` liefert dieselbe Policy aus, du siehst eine blockierte Anfrage also schon beim Entwickeln.

Details: [Apps im Überblick](/de/docs/developers/apps/overview/).

## Welche App-ID soll ich nehmen?

Deine Domain umgekehrt plus den App-Namen, drei bis fünf Teile, zum Beispiel `com.mueller.chat` oder `io.github.jan.chat`. Die Teile bestehen aus Kleinbuchstaben, Ziffern und Bindestrichen. `org.pithyx.*` ist für Systemapps und den offiziellen Katalog reserviert, aus einer Paketdatei lehnt die Box es ab.

Details: [Apps im Überblick](/de/docs/developers/apps/overview/).

## Wie kommt meine App in den Store?

Stell einen Pull Request mit dem Quellcode deiner App an den Community-Katalog `pithyx/apps-community`; das Projekt prüft ihn, und die CI baut, signiert und veröffentlicht die App. Oder betreib einen eigenen Katalog aus der Vorlage `pithyx/catalog-template`, den Administratoren im Store als nicht verifizierten Katalog hinzufügen. Jede Box kann deine `.pithyxapp`-Datei außerdem direkt installieren.

Details: [In einem Katalog veröffentlichen](/de/docs/developers/apps/publishing/).

## Kann ich die API aus einem Skript nutzen?

Ja, aber persönliche Zugriffstokens gibt es nicht: Ein Skript meldet sich wie der Desktop mit `POST /api/auth/login` an, behält das Cookie `pithyx_session` und schickt bei jeder Anfrage außer `GET` den Header `X-Pithyx-Request: 1` mit, auch beim Login. Der Daemon liefert sein OpenAPI-Dokument unter `/api/openapi.json` aus.

Details: [API](/de/docs/developers/daemon/api/).

