Erste Schritte
Die ThinForge-Oberfläche bedienst du im Browser. Dieser Abschnitt zeigt den Einstieg: Installation, Server aufrufen, einmaliger Setup-Assistent, Anmeldung und ein kurzer Rundgang durch die Oberfläche.
Installation
ThinForge läuft als Docker-Stack auf einem Server im lokalen Netz (Debian oder Ubuntu). Die Installation erledigt ein Bootstrap-Skript, das du einmalig auf dem frischen Server ausführst:
./bootstrap-release.sh
Es lädt die ThinForge-Komponenten, richtet die Grundkonfiguration samt automatisch erzeugter Zugangs-Geheimnisse ein (kein manuelles Bearbeiten nötig) und startet den kompletten Stack. Danach ist die Web-Oberfläche unter der Adresse des Servers erreichbar.
git muss auf dem Server vorhanden sein; alle weiteren Abhängigkeiten installiert das Skript selbst.Server aufrufen
Die Web-Oberfläche erreichst du über die HTTPS-Adresse deines ThinForge-Servers:
https://<server-hostname-oder-ip>/
Beim Erstaufruf zeigt der Browser eine Zertifikatswarnung — die Installation bringt zunächst ein selbst-signiertes Zertifikat mit. Sobald ein eigenes Zertifikat hinterlegt ist (siehe Einstellungen), verschwindet die Warnung.
Setup-Assistent
Beim allerersten Aufruf nach einer frischen Installation erscheint der Setup-Assistent. Er führt in sechs Schritten durch die Grundkonfiguration:
- Admin-Konto anlegen — E-Mail, Anzeigename, Passwort. Weitere Benutzer kommen später in den Einstellungen dazu.
- Server-Identität — Hostname und lokale Domain.
- DHCP / PXE — Subnetz und IP-Bereich für das Booten neuer Geräte sowie der Upstream-DNS.
- NTP — Zeitserver (Standard:
0.pool.ntp.org). - HTTPS / TLS — ein selbst-signiertes Zertifikat wird angelegt.
- Zusammenfassung — alle Eingaben prüfen und abschließen.
Nach Abschluss landest du auf dem Dashboard. Die Tools-ISO für die Erst-Einrichtung neuer Geräte wird nicht im Setup gebaut, sondern erst beim ersten Start der Cloning-VM.
Anmelden
Nach dem Setup meldest du dich mit den eben angelegten Admin-Zugangsdaten an. Weitere Operator- und Viewer-Konten entstehen in den Einstellungen.
Passwort vergessen? Der E-Mail-Versand eines Reset-Links ist derzeit noch nicht verfügbar. Setze das Passwort daher über eine andere Admin-Person in den Einstellungen neu.
Die Oberfläche
Das Fenster ist in drei Bereiche geteilt:
- Kopfleiste (oben) — Version, Benutzer-Menü, Hell-/Dunkel-Modus, Sprachwahl, Abmelden.
- Seitenleiste (links) — die Menüpunkte: Dashboard, Clients, Gruppen, Cloning, VPN, Netzwerk, Tasks, Berichte, Einstellungen, Logs, Info. Welche sichtbar sind, hängt von der Rolle ab.
- Hauptfläche (rechts) — der Inhalt zum gewählten Menüpunkt, meist mit einer Aktions-Leiste oben (Neu, Import, Export, Aktualisieren).
Dashboard anpassen
Oben rechts auf dem Dashboard liegt ein Zahnrad-Symbol. Damit blendest du Kacheln ein und aus und sortierst sie per Ziehen. Die Einstellung wird lokal im Browser gespeichert (pro Gerät).