archinstall
Advanced tools
This script provides a full unattended way to install ArchLinux from any live environment. You can create your own linux distribution based on the rolling released ArchLinux. A rock solid decorator pattern allows to automate a fully unattended individual installation process.
Simply load the newest version from:
>>> curl https://goo.gl/YbxT3F >archinstall.sh && chmod +x archinstall.sh
oder ohne Link-Shortener:
>>> curl \
https://torben.website/archinstall/data/distributionBundle/archinstall.sh \
>archinstall.sh && \
chmod +x archinstall.sh
neuste unstable Version:
>>> curl \
https://raw.githubusercontent.com/thaibault/archinstall/main/archinstall.sh \
>archinstall.sh && \
chmod +x archinstall.sh
archinstall ist das zentrale Modul um eine Reihe von Aufgaben im Zuge der Vorbereitung, Installation, Konfiguration oder Manipulieren eines "Linux from Scratch" durchzuführen.
Das Modul kann im einfachsten Fall (z.B. von einer beliebigen Live-Linux-Umgebung) gestartet werden. Zu beachten ist, dass die Installation von einem UEFI-System empfohlen wird, da dadurch entsprechende Boot-Einträge automatisch gesetzt werden können. Ein Bootloader wird nicht mit installiert und ist nicht notwendig, um das System zu booten.
>>> ./archinstall.sh
In diesem Fall werden alle benötigten Informationen zur Einrichtung (nur Hostname) des Systems vor Beginn des Installations Prozesses interaktiv abgefragt. Zu Beachten ist: ohne zusätzliche Parameter gibt das Modul keinen Feedback über den aktuellen Zustand des Installations Vorgangs. Mit:
>>> ./archinstall.sh --verbose
bekommt man einen etwas geschwätzigeren Installationsvorgang. Mit:
>>> ./archinstall.sh --verbose --debug
werden alle Ausgaben jeglicher verwendeten Subprogramme mit ausgegeben.
Alle Parameter wie Installations haben Standardwerte. So wird im obigen Fall einfach in das aktuelle Verzeichnis ein Ordner mit dem Programmnamen erstellt und darin das Betriebssystem installiert (./archinstall/). Möchte man eine unbeaufsichtigte Installation:
>>> ./archinstall.sh --auto-partitioning --host-name testSystem
Im typischen Fall will man von einer Live-CD booten um das System auf einer Festplatte oder Partition zu installieren. Hierbei müssen folgende Aufgaben erfüllt werden.
Alle Aufgaben bis auf die Einrichtung der Internet Verbindung (wird in der Regel von der Host Umgebung geregelt) könne mit archinstall automatisiert durchgeführt werden. Will man z.B auf das Block Device "/dev/sdb" installieren und sich nicht selber um die Partitionierung kümmern und den kompletten verfügbaren Platz für das Haupt System verwenden (es soll also keine Swap- oder Daten Partition erstellt werden). sieht das z.B. so aus:
>>> ./archinstall.sh --auto-partitioning --target /dev/sdb
Auf diese Weise wird eine uefi Boot-Partition mit 2 GigaByte eingerichtet. Der restliche Platz wird für die Systempartition eingesetzt. Sind noch weitere Partitionen gewünscht kann man diese während der Installation durch weglassen des entsprechenden Parameters selber konfigurieren. Die erste Partition wird dann als Boot-Partition und die Zweite als Systempartition betrachtet. Weitere Partitionen werden ignoriert. Manuelle Partitionierung:
>>> ./archinstall.sh --target /dev/sdb
Archinstall erstellt alle Partition mit Labels sowohl in der Partitionstabelle als auf der Partition selbst. Um dieses Verhalten zu individualisieren, können folgende Optionen genutzt werden:
>>> ./archinstall.sh \
--boot-partition-label uefiBoot \
--system-partition-label system
Um z.B. aus einem Produktivsystem heraus eine alternative Linux Distribution auf eine weitere Partition zu installieren kann einfach folgender Befehl verwendet werden:
>>> ./archinstall.sh --target /dev/sdb2
Hier wird auf die zweite Partition des zweiten Block Devices installiert. archinstall versucht bei der Installation auf ein Blockdevice stets einen entsprechenden Uefi-Boot-Eintrag für den Kernel mit einem Standard Initramfs und einem Ausweich-Initiramfs zu konfigurieren. Die folgenden Parameter definieren dessen Label:
>>> ./archinstall.sh \
--boot-entry-label archLinux \
--fallback-boot-entry-label archLinuxFallback \
--target /dev/sdb2
Um archinstall für komplexere Szenarien zu verwenden oder nachträgliche Manipulationen vorzunehmen ist es sinnvoll zunächst in einen Ordner zu installieren. Siehe hierzu "archinstall with Decorator Pattern", "makeXBMCLinux", "makeRamOnlyLinux" oder "makeSquashLinux" bzw. das Projekt "archinstallWrapperTemplate".
Dieser Befehl installiert ein vollständiges System in den eigenen Home-Ordner "test" (siehe auch Installation ohne root Rechte).
>>> ./archinstall.sh --target ~/test
archinstall konfiguriert das neu eingerichtete System vollautomatisch. Folgende Tasks wurden automatisiert:
Will man hierauf selber Einfluss nehmen, gibt es folgende Möglichkeiten:
>>> ./archinstall.sh \
--additional-packages python vim \
--country-with-mirrors Germany \
--cpu-architecture x86_64 \
--host-name test \
--keyboard-layout de-latin1 \
--local-time /Europe/London \
--needed-services sshd dhcpcd apache \
--prevent-using-pacstrap \
--user-names test
Um die einzelnen Konfigurationsparameter zu verstehen empfiehlt sich ein Blick auf:
>>> ./archinstall.sh --help
zu werfen.
Viele nützlich Umgebungsvariablen und Funktionen können mit
>>> source archinstall.sh --load-environment
geladen werden. Um eine Übersicht zu erhalten sollte man sie die API-Dokumentation anschauen.
archinstall stellt ein Alphabet voller Optionen zur Verfügung. Während bisher zum einfachen Verständnis immer Long-Options verwendet wurden, gibt es für jede Option auch einen Shortcut.
>>> ./archinstall.sh --user-names mustermann --host-name lfs
ist äquivalent zu:
>>> ./archinstall.sh -u mustermann -n lfs
Alle Optionen bis auf "--host-name" und "--auto-partitioning" haben Standardwerte. Diese beiden werden sofern nicht von vorne herein angegeben interaktiv abgefragt. Alle Standardwert können mit Hilfe von:
>>> ./archinstall.sh -h
oder
>>> ./archinstall.sh --help
oder
>>> ./archinstall.sh --keyboard-layout de-latin1 -h
eingesehen werden. Letzteres macht Sinn, da sich Standardwerte aufgrund schon ermittelten Informationen verändern können. So wird der Standardwert von "--key-map-configuration="KEYMAP=de-latin1\nFONT=Lat2-Terminus16\nFONT_MAP=" nach Eingabe von
>>> ./archinstall.sh --keyboard-layout us
zu: "--key-map-configuration="KEYMAP=us\nFONT=Lat2-Terminus16\nFONT_MAP=".
Der Standardwert von "--cpu-architecture" entspricht beispielsweise immer der Architektur des aktuellen Systems, um Konfigurationsaufwand zu minimieren.
Man kann Optionen die mehrere Werte annehmen auch mehrfach referenzieren. So hat:
>>> ./archinstall.sh \
--additional-packages ssh \
--additional-packages vim \
-g python
den gleichen Effekt wie:
>>> ./archinstall.sh --additional-packages ssh vim python
archinstall erstellt bei jeder Installation automatisch einen Paket-Cache, um weitere Installationen zu beschleunigen. Ist dieser einmal erstellt oder wird dieser zusammen mit dem archinstall (z.b. auf einem usb-stick) ausgeliefert kann Offline installiert werden.
Selbst wenn mit einem bereits vorhandenem pacstrap installiert wird, wird dieser temporär kopiert, gepatched und anschließend offlinefähig ausgeführt!
Bei Offline Installation müssen natürlich alle zusätzlich ausgewählten Pakete im Package Cache vorhanden sein. Ist dies nicht der Fall wird archinstall versuchen diese nach zu laden und im Offline-Fall einen Fehler zurückgeben.
Prinzipiell ist es möglich auch ohne root Rechte ein System aufzusetzen. Hierbei werden jedoch folgende Einschnitte gemacht:
Während der Entwicklung haben sich eine Reihe von Optionen bewährt um Fehler bei der Entwicklung von Wrappern zu finden.
Die Option "--prevent-using-pacstrap" oder "-p" verhindert ein bereits installierten Pacman für die Installation zu verwenden. Dies ist notwendig wenn man sein Pacman so konfiguriert hat, das z.B. Pakete wie der Kernel oder Pacman von manipulierten User Repositories abhängen. Mit "--prevent-using-pacstrap" wird eine neue Version von Pacman in einer Change-Root-Umgebung ausgeführt.
Möchte man die Pakete "base-devel", "sudo" und "python" haben, geht das mit dem Shortcut: "--install-common-additional-packages" oder "-z".
Will man eine beliebige Liste von Paketen integrieren:
>>> ./archinstall.sh --additional-packages ssh python2 vim
Sollen Dienste schon beim ersten Start automatisch gestartet werden:
>>> ./archinstall.sh --needed-services sshd dhcpcd
Um die Installation zu beschleunigen kann auf ein Cache verwiesen werden:
>>> ./archinstall.sh --cache-path /var/cache/archinstall/
FAQs
automate your installation process
The npm package archinstall receives a total of 214 weekly downloads. As such, archinstall popularity was classified as not popular.
We found that archinstall demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 0 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Newly introduced telemetry in devenv 1.4 sparked a backlash over privacy concerns, leading to the removal of its AI-powered feature after strong community pushback.
Security News
TC39 met in Seattle and advanced 9 JavaScript proposals, including three to Stage 4, introducing new features and enhancements for a future ECMAScript release.
Security News
Deno 2.2 enhances Node.js compatibility, improves dependency management, adds OpenTelemetry support, and expands linting and task automation for developers.