Anleitung

Für Nutzer

Erste Schritte

1. Öffne die Adresse deines IceOS im Browser (am Computer, Tablet oder Handy).
2. Du kannst sofort als Gast hineinschauen. Gäste speichern nichts auf dem Server; alles bleibt in diesem Browser.
3. Mit einem Konto bekommst du Speicher auf dem Server, und dein Desktop sieht auf jedem Gerät gleich aus. Melde dich über „Einstellungen → Konto → Anmelden“ oder den Sperrbildschirm an.
4. Beim ersten Start zeigt die Willkommens-Tour in sechs Schritten, wie alles zusammenhängt. Du kannst sie jederzeit über die App Willkommen wiederholen.

Desktop und Fenster

• Apps öffnen: Doppelklick auf ein Symbol oder über das Startmenü (Schneeflocke unten links).
• Fenster: an der Titelleiste ziehen, am Rand die Größe ändern, minimieren, maximieren, schließen. Zieht man ein Fenster an den Rand, rastet es ein.
• Taskleiste: zeigt offene Fenster, Uhr, Datum und Benachrichtigungen. Sie kann sich in den Einstellungen automatisch ausblenden.
• Handy und Tablet: tippe Symbole an; Fenster passen sich dem Bildschirm an.

Dateien

Im Datei-Explorer findest du „Mein Speicher“ auf dem Server (mit Platzgrenze), diesen Browser und, wenn dein Admin sie angebunden hat, weitere Laufwerke.

• Neu, Umbenennen, Löschen: Rechtsklick oder die Knöpfe oben. Gelöschtes landet im Papierkorb und lässt sich zurückholen.
• Ansichten: Details, Liste oder Kacheln; sortieren durch Klick auf die Spaltenüberschrift.
• Eigenschaften: zeigt Größe, Änderungsdatum und bei Ordnern, wie viel darin liegt.
• Hochladen: Dateien aus dem Betriebssystem einfach auf den Explorer ziehen.

Apps

Welche Apps du siehst, bestimmt dein Betreiber. Kostenlose Apps sind immer da, andere je nach Lizenz. Im App Store siehst du alle Apps; steht dort „gesperrt“, erklärt „Warum ist die App gesperrt?“ den Grund und was zu tun ist.

• Alltag: Rechner, Uhr (Wecker, Stoppuhr, Timer), Notizen, Editor, Paint, Whiteboard, QR-Code, Pastebin.
• Medien: Bildbetrachter, Medienplayer, PDF-Betrachter, Radio.
• Internet: Browser (Seiten, die sich nicht einbetten lassen, öffnen im abgeschotteten Remote-Browser), Links, Chat.

Einstellungen

Hintergrund, helles oder dunkles Design, Akzentfarbe, Sprache (Deutsch oder Englisch), Taskleiste, Datum und Zeitzone, Benachrichtigungen, Datenschutz und Konto. Die Seite Server merkt sich mehrere IceOS-Server, die du benutzt.

Konto und Sicherheit

• Passwort: mindestens 10 Zeichen. Vergessen? Dein Admin kann es zurücksetzen.
• Zweiter Faktor (2FA): in Einstellungen → Konto aktivierbar. Notiere die Wiederherstellungscodes an einem sicheren Ort.
• Abmelden beendet die Sitzung auf diesem Gerät. Der Sperrbildschirm schützt den Desktop, wenn du kurz weg bist.

Rückmeldung senden

Im Profilmenü oder in den Einstellungen kannst du einen Wunsch oder Fehler melden. Jede Rückmeldung ist ein Ticket: Unter „Meine Rückmeldungen“ siehst du den Stand (neu, gesehen, in Arbeit, erledigt) und die Antworten des Betreibers, und du kannst antworten. Neue Antworten zeigt IceOS beim Start an.

API-Schlüssel (für Skripte)

In Einstellungen → API-Schlüssel erzeugst du einen persönlichen Schlüssel („nur lesen“ oder „lesen und hochladen“). Er wird nur einmal angezeigt; kopiere ihn sofort. Damit kann ein Skript Dateien in deinem Serverspeicher auflisten, herunterladen und hochladen, mehr nicht. Du kannst Schlüssel jederzeit widerrufen und ein Ablaufdatum setzen.

Tastenkürzel

• Strg+Alt+A – Verwaltung öffnen (nur Administratoren)
• Esc – Menü oder Dialog schließen
• Tab / Umschalt+Tab – durch Bedienelemente springen; Enter bestätigt

Wenn etwas nicht geht

• App ist gesperrt: im App Store „Warum ist die App gesperrt?“ lesen; meist fehlt eine Lizenz oder ein Platz. Frage deinen Admin.
• Seite wirkt veraltet: Browserseite neu laden (Strg+F5).
• Zwei Tabs offen: schließe den zweiten Tab, sonst können sich Einstellungen überschreiben.
• Dein Desktop sieht auf einem Gerät anders aus: melde dich an; ohne Konto bleibt alles nur in diesem Browser.
• Nichts hilft? Schicke eine Rückmeldung mit dem Haken „Technische Angaben mitsenden“.

Für Administratoren und Betreiber

Installieren

Voraussetzung: Docker (auf Windows Docker Desktop). Sonst nichts.

Der einfache Weg: Auf der Startseite im Abschnitt Frontend installieren die Adresse eintragen und den fertigen Befehl auf dem Server einfügen. Er lädt das Paket, prüft die Prüfsumme und startet alles. Von Hand geht es so:

1. Paket unter Download herunterladen und die Prüfsumme vergleichen.
2. Entpacken. Windows: Doppelklick auf IceOS-Installieren.cmd. Linux/Mac: sh install.sh.
3. Warten, bis „Fertig! IceOS läuft“ erscheint, dann die genannte Adresse öffnen (Standard http://127.0.0.1:8080).

Ohne Docker, auf einfachem Webspace mit PHP: das PHP-Paket (ZIP) hochladen und install im Browser öffnen. Es hat keine API-Schlüssel und keine Docker-Apps.

Erste Einrichtung

1. Im Desktop: Einstellungen → Konto → Administrator anlegen (oder den Sperrbildschirm anklicken).
2. Im Formular entweder den Aktivierungsschlüssel eingeben (vom Anbieter) oder den Einrichtungscode aus dem Server-Protokoll (docker compose logs frontend). Dann Benutzername und ein Passwort mit mindestens 10 Zeichen wählen. „Passwort anzeigen“ hilft beim Prüfen.
3. Der Einrichtungsassistent fragt Name der Installation, Sprache, ob Gäste hereinschauen dürfen und die Adresse. Alles ist später in Verwaltung → Einstellungen änderbar.
4. Den Aktivierungsschlüssel für die ganze Installation gibst du in Verwaltung → Lizenz oder im App Store ein. Ohne Aktivierung laufen nur die kostenlosen Apps.

Aktivierung und Lizenzen

• Pakete und Apps: Ein Schlüssel schaltet Apps für die ganze Installation oder für Plätze frei.
• Plätze: Manche Lizenzen gelten pro Benutzer. Unter Verwaltung → Lizenz vergibst du die Plätze; nur wer einen Platz hat, bekommt die App. Der Main Server erfährt nur die Anzahl, keine Namen.
• Widerruf und Ablauf: Der Betreiber kann Schlüssel widerrufen oder befristen. Dein Frontend gleicht regelmäßig ab; ohne Verbindung läuft es eine Frist lang weiter.

Benutzer und Anmeldung

• Verwaltung → Benutzer: Administrator geben oder entziehen, sperren, Sitzungen beenden, Passwort zurücksetzen.
• Verwaltung → Anmeldung: lokale Konten mit Passwort anlegen; OAuth2 (Anmeldung über einen Anbieter) wird per Umgebungsvariablen eingerichtet. Lege vor dem Abschalten von OAuth2 mindestens einen Passwort-Administrator an.
• Verwaltung → Protokoll: wer wann was getan hat (Anmeldungen, Änderungen).

Speicher und Laufwerke

Jeder Benutzer hat „Mein Speicher“ mit Platzgrenze. Unter Verwaltung → Speicher bindest du Netzlaufwerke an (WebDAV, FTP, SFTP oder einen Ordner auf dem Server, darüber auch SMB- und NFS-Freigaben). Zugangsdaten werden verschlüsselt gespeichert und nie wieder angezeigt. „Verbindung testen“ prüft vor dem Anbinden.

Remote-Browser und Code-Editor

Unter Verwaltung → Docker erlaubst du dem Frontend, abgeschottete Container für den Remote-Browser (und optional den Code-Editor) zu starten. Es nutzt eine feste Vorlage: ein Image, eigenes Netzwerk, ohne Rechte, mit Grenzen. Der Zugriff auf Docker ist mächtig; binde ihn nur ein, wenn du dem Server vertraust, am besten über einen Socket-Proxy.

Eigene Apps und Links

Verwaltung → Eigene Apps: Links (öffnen in neuem Tab) oder Fenster mit eingebetteter Seite (nur https). Browser-Kacheln ändern die Startseite des Browsers. Unter Einstellungen trägst du Links für den Sperrbildschirm ein.

Rückmeldungen beantworten

Rückmeldungen deiner Nutzer gehen als Tickets an den Betreiber des Main Servers. Dort antwortest du in der Betreiber-Seite unter Rückmeldungen → Verlauf und Antwort und setzt den Stand (neu, gesehen, in Arbeit, erledigt, abgelehnt). Eine interne Notiz sieht der Absender nie. Antwortet der Absender, öffnet sich ein erledigtes Ticket wieder.

Betrieb und Sicherung

• Updates: Desktop und Apps kommen automatisch und signiert vom Main Server. Das Programm selbst aktualisierst du mit dem neuen Paket (Installer erneut ausführen; Daten bleiben).
• Sicherung: Datenbank und den Ordner secrets/ regelmäßig sichern (beim Betreiber-Installer mit sh backup.sh) und an einem anderen Ort ablegen. Volumes nie einfach löschen.
• HTTPS: vor das Frontend gehört ein Proxy mit Zertifikat. Keine Container-Ports ins Internet öffnen.
• Mehrere Server: Nutzer können sich in Einstellungen → Server mehrere Adressen merken.

Betreiber-Seite und Shop

Wer IceOS anbietet, richtet mit dem Betreiber-Installer (Linux, Docker, hinter einem Reverse-Proxy) den Main Server, diese Landing-Seite, den Shop und die Betreiber-Seite unter /admin ein.

• Lizenzen: Preise und Pakete festlegen, Schlüssel erzeugen und widerrufen.
• Shop: Zahlungsarten wählen, Zahlungseingang bestätigen („Zahlung ist da“), danach werden Schlüssel erzeugt und per E-Mail verschickt.
• Rechtliches: in den Shop-Einstellungen Links zu Bedingungen, Impressum und Datenschutz eintragen; sie erscheinen im Shop und unten auf dieser Seite. Die Texte selbst gehören auf deine Webseite.
• Kunden-Rechte: Im Shop können Kunden ihre Daten herunterladen, Rechnungen als PDF laden und ihr Konto löschen.
• E-Mail: in den Einstellungen den SMTP-Server eintragen und „Test-E-Mail senden“ prüfen.
• Downloads: Pakete (Docker, PHP) mit Prüfsumme bereitstellen.

Sicherheit in Kürze

• Zweiten Faktor für das Admin-Konto einschalten und einen Notfall-Administrator anlegen.
• Signaturschlüssel und Shop-Geheimnis offline sichern; öffentliche Schlüssel sind gepinnt und werden nie geändert.
• API-Schlüssel nur für Skripte, die sie brauchen, und mit „nur lesen“, wenn Schreiben nicht nötig ist.
• Vor dem Livegang die Prüfliste im Projekt (IceOS_Struktur/RELEASE.md) abhaken.