Zum Inhalt springen
Chapters
  1. Willkommen bei Omarchy!
  2. Erste Schritte
  3. Von Mac oder Windows kommen
  4. Navigation
  5. Die obere Leiste
  6. Themes
  7. Tastenkombinationen
  8. Einheitliche Zwischenablage & Verlauf
  9. Erinnerungen
  10. Hinweise
  11. Textextraktion & Diktat
  12. Screenshots & Aufnahme
  13. Toggles, Leerlauf und der Bildschirmschoner
  14. Omarchy CLI
  15. Terminal
  16. Neovim
  17. AI
  18. Entwicklungs-Tools
  19. Shell-Werkzeuge
  20. Shell-Funktionen
  21. TUIs
  22. GUIs
  23. Browser
  24. Kommerzielle Apps/Dienste
  25. Web-Apps
  26. Gaming
  27. PDFs ausfüllen
  28. Windows-VM
  29. Andere Pakete
  30. Updates
  31. Dotfiles
  32. Shell-Plugins
  33. Monitore
  34. Tastatur, Maus, Trackpad
  35. Netzwerk
  36. Ruhezustand des Systems
  37. Hardware-Authentifizierung
  38. Schriftarten
  39. Hintergründe
  40. Prompt
  41. Branding
  42. Häufige Anpassungen
  43. Dein eigenes Theme erstellen
  44. Mac-Unterstützung
  45. Fehlerbehebung
  46. Häufige Fragen
  47. Systemsnapshots
  48. Sicherheit
  49. Omarchy auf...
  50. Dual-Boot-Installation
  51. Unbeaufsichtigte Installationen

Handbuch

Unbeaufsichtigte Installationen

Die Omarchy-ISO kann sich selbst installieren, ohne dass jemand an der Tastatur sitzt. Findet das Installationsprogramm ein zweites Laufwerk mit der Bezeichnung cidata, das seine Konfigurationsdateien enthält, kopiert es sie herunter, überspringt den Einrichtungsassistenten vollständig und startet von selbst neu in das fertige System. Kein spezieller ISO-Build, kein zusätzlicher Eintrag im Boot-Menü - ist kein solches Laufwerk angeschlossen, ändert sich nichts und du bekommst den normalen Assistenten.

Damit eignet sich Omarchy hervorragend als Basis-Image für wegwerfbare Entwicklungsumgebungen: Erstelle eine VM in Proxmox oder mit Packer, starte sie, geh weg, verbinde dich per SSH. cidata ist die NoCloud-Bezeichnung von cloud-init, sodass alle gängigen Virtualisierungswerkzeuge bereits wissen, wie sie ein solches Laufwerk anhängen.

Die Konfigurationsdateien

Die Dateien sind genau das, was der eigene Assistent des Installationsprogramms schreibt. Am einfachsten bekommst du also einen Startsatz, indem du eine interaktive Installation durchführst (etwa in einer VM) und kopierst, was sie nach /root geschrieben hat:

Datei Erforderlich Zweck
user_configuration.json Ja Festplatte, Hostname, Zeitzone, Tastatur
user_credentials.json Ja Benutzername und Passwort-Hash
user_encrypt_installation.txt Nein true, wenn die Konfiguration einen disk_encryption-Block enthält
authorized_keys Nein Öffentliche SSH-Schlüssel, einer pro Zeile
tailscale_authkey Nein Tailscale-Authentifizierungsschlüssel, um beim ersten Start deinem Tailnet beizutreten

Erzeuge den Passwort-Hash für user_credentials.json mit openssl passwd -6 "yourpassword".

Name und E-Mail für Git-Commits sind nicht Teil der Installation. Lege sie fest, sobald die Maschine läuft, zum Beispiel über SSH, mit omarchy setup git --name "Jane Doe" --email jane@example.com.

Du kannst auch eine leere Datei namens defer-provisioning anstelle von user_credentials.json ablegen. Das führt dieselbe Installation zur Vorbereitung für einen anderen Besitzer aus, die du auch interaktiv auslösen kannst: Die Maschine wird ohne persönliche Angaben installiert, und wer sie zuerst startet, wählt seine Tastatur und erstellt seinen Benutzer. Das ist der Modus für Imaging-Rigs, bei denen das Laufwerk überhaupt keine Zugangsdaten von irgendwem enthalten sollte.

SSH-Zugriff

Ist authorized_keys vorhanden, richtet die Installation die Schlüssel als ~/.ssh/authorized_keys des Benutzers ein, aktiviert sshd und öffnet die Firewall dafür. (Eine Standardinstallation von Omarchy liefert openssh mit deaktiviertem Dienst und geschlossenem Port aus, sodass eine unbeaufsichtigte Maschine sonst unerreichbar wäre.) Die Installation fügt nur deine Schlüssel hinzu - sie lockert keine der anderen Authentifizierungseinstellungen des SSH-Daemons.

Ist tailscale_authkey vorhanden, tritt die Maschine stattdessen beim ersten Start deinem Tailnet bei: Tailscale wird aus den mitgelieferten Paketen der ISO installiert, die Firewall lässt die Tailnet-Schnittstelle zu, und ein Hintergrundjob führt den Beitritt aus, sobald die Maschine tatsächlich Netzwerk hat, und versucht es so lange weiter, bis es klappt. Verwende einen wiederverwendbaren, vorab autorisierten Schlüssel, damit ein einziges Laufwerks-Image für viele Maschinen dienen kann.

Das cidata-Laufwerk erstellen

Jedes Dateisystem mit der richtigen Bezeichnung funktioniert. Eine winzige ISO ist der einfache Weg:

mkdir cidata
cp user_configuration.json user_credentials.json authorized_keys cidata/
genisoimage -output cidata.iso -volid cidata -joliet -rock cidata/

Hänge sie dann zusammen mit der Omarchy-ISO an die VM an. Hier ist ein vollständiges Proxmox-Beispiel:

qm create 101 --name my-omarchy \
  --bios ovmf --machine q35 --cpu host --cores 4 --memory 8192 \
  --ostype l26 --scsihw virtio-scsi-single \
  --efidisk0 local-lvm:0,efitype=4m,pre-enrolled-keys=0 \
  --scsi0 local-lvm:40,discard=on,iothread=1 \
  --net0 virtio,bridge=vmbr0 --vga virtio --serial0 socket \
  --ide2 local:iso/omarchy.iso,media=cdrom \
  --ide3 local:iso/cidata.iso,media=cdrom \
  --boot order='scsi0;ide2'

qm start 101

Die Boot-Reihenfolge führt die Festplatte absichtlich zuerst auf: Die leere Festplatte fällt beim ersten Start auf die ISO durch, und danach startet das installierte System für immer von der Festplatte.

Zwei Vorbehalte

Verschlüsselte unbeaufsichtigte Installationen sind nicht vollständig unbeaufsichtigt - jemand muss beim ersten Start immer noch die LUKS-Passphrase eingeben. Und der disk_encryption-Block in user_configuration.json enthält diese Passphrase im Klartext. Behandle ein cidata-Laufwerk, das aus einer verschlüsselten Installation erstellt wurde, also wie das Geheimnis, das es ist.