258 lines
10 KiB
Markdown
258 lines
10 KiB
Markdown
# FWS
|
||
|
||
**FWS** est une distribution Linux live/installable basée sur **Arch Linux**, livrée sous forme d'ISO bootable BIOS/UEFI avec l'installeur graphique **Calamares** lancé automatiquement au démarrage.
|
||
|
||
Le projet est conçu pour être **construit depuis Windows via WSL** (les scripts détectent Git Bash et basculent automatiquement dans WSL), mais fonctionne aussi directement depuis une Arch Linux native.
|
||
|
||
---
|
||
|
||
## Aperçu
|
||
|
||
- **Base** : Arch Linux (rolling release)
|
||
- **Installeur** : Calamares 3.4.2 (compilé depuis l'AUR, servi via un repo pacman local)
|
||
- **Affichage live** : Xorg + Openbox, lancement automatique de Calamares
|
||
- **Bureaux installables** : XFCE, KDE Plasma, GNOME, Hyprland (choix à l'installation)
|
||
- **Boot** : BIOS (syslinux) + UEFI (systemd-boot)
|
||
- **Compression** : squashfs (xz)
|
||
|
||
---
|
||
|
||
## Environnement requis — INSTALLATION ULTRA PRÉCISE
|
||
|
||
### Côté Windows (machine hôte)
|
||
|
||
| Composant | Version / état requis | Commande de vérif |
|
||
|---|---|---|
|
||
| Windows | 10 (22H2+) ou 11 | `winver` |
|
||
| WSL | **WSL 2** (pas WSL 1) | `wsl --status` |
|
||
| Virtualisation CPU | Activée dans le BIOS (VT-x / AMD-V) | Gestionnaire des tâches → Performance → CPU → "Virtualisation : Activé" |
|
||
| Git for Windows | ≥ 2.40 (fournit Git Bash) | `git --version` |
|
||
| Espace disque libre | ≥ 25 GB sur la partition WSL | — |
|
||
| RAM | ≥ 8 GB (16 GB recommandés) | — |
|
||
|
||
#### 1. Activer WSL 2
|
||
|
||
Dans **PowerShell administrateur** :
|
||
|
||
```powershell
|
||
wsl --install --no-distribution
|
||
wsl --set-default-version 2
|
||
wsl --update
|
||
```
|
||
|
||
Puis **redémarrer Windows**.
|
||
|
||
#### 2. Installer Arch Linux dans WSL
|
||
|
||
Arch n'est pas dans le store Microsoft. Installer **ArchWSL** :
|
||
|
||
```powershell
|
||
# Télécharger la dernière release
|
||
Invoke-WebRequest -Uri "https://github.com/yuk7/ArchWSL/releases/latest/download/Arch.zip" -OutFile "$env:TEMP\Arch.zip"
|
||
Expand-Archive "$env:TEMP\Arch.zip" -DestinationPath "$env:LOCALAPPDATA\ArchWSL"
|
||
& "$env:LOCALAPPDATA\ArchWSL\Arch.exe"
|
||
```
|
||
|
||
Au premier lancement, la distribution s'enregistre sous le nom **`Arch`** (ce nom est attendu par les scripts — il est paramétrable via `ARCH_WSL_DISTRO` si besoin).
|
||
|
||
Vérifier :
|
||
|
||
```powershell
|
||
wsl -l -v
|
||
# Doit afficher :
|
||
# NAME STATE VERSION
|
||
# * Arch Stopped 2
|
||
```
|
||
|
||
#### 3. Installer Git for Windows
|
||
|
||
Télécharger depuis https://git-scm.com/download/win et installer avec les options par défaut. **Git Bash** est inclus.
|
||
|
||
---
|
||
|
||
### Côté WSL Arch (préparation système)
|
||
|
||
Le **premier lancement** de la WSL ouvre une session root. Effectuer une seule fois :
|
||
|
||
```bash
|
||
# 1. Initialiser le keyring (sinon pacman refuse tout install signé)
|
||
pacman-key --init
|
||
pacman-key --populate archlinux
|
||
|
||
# 2. Mettre à jour le keyring AVANT toute autre opération
|
||
# (les WSL fraîches ont un keyring périmé)
|
||
pacman -Sy --noconfirm archlinux-keyring
|
||
|
||
# 3. Mise à jour complète du système
|
||
pacman -Syu --noconfirm
|
||
|
||
# 4. Vérifier que /tmp est bien un tmpfs (sinon mkarchiso lent)
|
||
mount | grep '/tmp'
|
||
```
|
||
|
||
> **Note** : le script `setup-calamares.sh` désactive automatiquement le sandbox landlock de pacman ≥ 7 (incompatible avec le kernel WSL) en ajoutant `DisableSandbox` dans `/etc/pacman.conf`. Tu n'as rien à faire.
|
||
|
||
---
|
||
|
||
### Côté Arch Linux native (alternative)
|
||
|
||
Si tu build depuis une vraie Arch (pas WSL) :
|
||
|
||
```bash
|
||
sudo pacman -Syu
|
||
sudo pacman -S --needed base-devel git archiso reflector dos2unix
|
||
```
|
||
|
||
Les scripts détectent l'absence de WSL et s'exécutent en local. Il faut être **root** ou avoir `sudo` configuré.
|
||
|
||
---
|
||
|
||
## Démarrage rapide
|
||
|
||
Depuis **Git Bash sur Windows** (à la racine du repo) :
|
||
|
||
```bash
|
||
# Étape 1 : compilation de Calamares + winboat depuis l'AUR
|
||
# → crée local-repo/ avec les .pkg.tar.zst signés
|
||
./setup-calamares.sh
|
||
|
||
# Étape 2 : build de l'ISO via mkarchiso
|
||
# → fusionne configs/releng + configs/baseline
|
||
# → injecte le repo local dans pacman.conf
|
||
# → sort l'ISO dans ./out/
|
||
./build.sh
|
||
```
|
||
|
||
L'ISO finale est générée dans `./out/FWS-YYYY.MM.DD-x86_64.iso`.
|
||
|
||
---
|
||
|
||
## Ce que fait `setup-calamares.sh` (étape par étape)
|
||
|
||
1. **Détection environnement** : si lancé depuis Git Bash, bascule dans `wsl.exe -d Arch -u root`.
|
||
2. **Patch pacman** : désactive landlock sur WSL (`DisableSandbox`).
|
||
3. **Refresh keyring** : `pacman-key --init && --populate archlinux`, mise à jour `archlinux-keyring`.
|
||
4. **`pacman -Syu`** complet (obligatoire — sinon `makepkg` plante sur les "conflicting files" lors des splits de paquets type `gcc-libs`).
|
||
5. **Install des outils de build** : `base-devel git`.
|
||
6. **Création d'un utilisateur `fwsbuild`** non-root avec `sudo` NOPASSWD (makepkg refuse de tourner en root).
|
||
7. **Clone + build AUR** : `calamares` puis `winboat-bin` via `makepkg -s --noconfirm`.
|
||
8. **Création du repo local** : `repo-add local-repo/fws-local.db.tar.gz`.
|
||
9. **Cleanup** : suppression de l'utilisateur `fwsbuild`.
|
||
|
||
**Durée** : 15–40 minutes (Calamares = ~12 dépendances Qt6 à compiler).
|
||
|
||
---
|
||
|
||
## Ce que fait `build.sh` (étape par étape)
|
||
|
||
1. **Détection environnement** : Git Bash → bascule dans WSL ; sinon exécution locale.
|
||
2. **Update miroirs** : `reflector --latest 10 --sort rate`.
|
||
3. **Install `archiso`**.
|
||
4. **Fusion configs** : `cp -ar configs/releng/* /tmp/fws-build/releng/` puis overlay `configs/baseline/*` par-dessus (baseline prioritaire).
|
||
5. **Activation NetworkManager** sur le live (symlink réel `multi-user.target.wants/`).
|
||
6. **Injection du repo local** : ajoute `[fws-local]` (`SigLevel = Optional TrustAll`) en tête de `pacman.conf`.
|
||
7. **`dos2unix`** sur l'arborescence (au cas où tu as édité depuis Windows).
|
||
8. **`mkarchiso -v -w /tmp/fws-build/work -o out/ /tmp/fws-build/releng`**.
|
||
9. **Cleanup** du workdir.
|
||
|
||
**Durée** : 5–15 minutes selon la machine et le cache pacman.
|
||
|
||
---
|
||
|
||
## Test rapide en QEMU
|
||
|
||
```bash
|
||
./scripts/run_archiso.sh -i out/FWS-*.iso # BIOS
|
||
./scripts/run_archiso.sh -u -i out/FWS-*.iso # UEFI
|
||
```
|
||
|
||
---
|
||
|
||
## Structure du projet
|
||
|
||
| Chemin | Rôle |
|
||
|---|---|
|
||
| `setup-calamares.sh` | Build Calamares + winboat depuis l'AUR, crée `local-repo/` |
|
||
| `build.sh` | Build de l'ISO via `mkarchiso` |
|
||
| `configs/releng/` | Profil principal (base ArchISO releng) |
|
||
| `configs/baseline/` | Overlay FWS (Calamares, branding, scripts desktop-init) — **prioritaire** sur releng |
|
||
| `local-repo/` | Repo pacman local (généré par `setup-calamares.sh`) |
|
||
| `out/` | ISOs générées |
|
||
| `fws/mkarchiso` | Binaire `mkarchiso` embarqué (fork) |
|
||
| `scripts/run_archiso.sh` | Lanceur QEMU |
|
||
|
||
---
|
||
|
||
## Séquence de boot de l'ISO
|
||
|
||
1. Démarrage de l'ISO FWS (BIOS ou UEFI)
|
||
2. `systemd` → autologin root sur `tty1`
|
||
3. `.zprofile` → `startx`
|
||
4. `.xinitrc` → Openbox + Calamares
|
||
5. Utilisateur choisit son bureau (XFCE / KDE / GNOME / Hyprland) via `packagechooser`
|
||
6. Calamares installe le système → `shellprocess` appelle `/usr/local/bin/fws-desktop-init-<bureau>` qui installe les paquets et configure le display manager
|
||
7. Reboot → connexion automatique sur le bureau choisi
|
||
|
||
---
|
||
|
||
## Personnalisation
|
||
|
||
- **Paquets du live** : `configs/releng/packages.x86_64`
|
||
- **Paquets baseline** : `configs/baseline/packages.x86_64`
|
||
- **Overlay rootfs** : `configs/releng/airootfs/` ou `configs/baseline/airootfs/`
|
||
- **Modules / séquence Calamares** : `configs/baseline/airootfs/etc/calamares/settings.conf`
|
||
- **Choix des bureaux** : `configs/baseline/airootfs/etc/calamares/modules/packagechooser.conf`
|
||
- **Scripts d'install bureau** : `configs/releng/airootfs/usr/local/bin/fws-desktop-init-*`
|
||
- **Branding ISO** : `configs/releng/profiledef.sh` (`iso_name`, `iso_label`, `iso_publisher`)
|
||
- **Branding Calamares** : `configs/baseline/airootfs/etc/calamares/branding/fws/`
|
||
|
||
---
|
||
|
||
## Dépannage
|
||
|
||
| Symptôme | Cause / fix |
|
||
|---|---|
|
||
| `Aucune distribution WSL Arch joignable` | Aucune distro Arch n'est installée/joignable. Les scripts auto-détectent désormais toute distro dont le nom contient « arch » (via `wsl -l -q`) ; installe ArchWSL (nom `Arch`) ou `wsl --install -d archlinux`, ou force `ARCH_WSL_DISTRO=NomDeMaDistro`. |
|
||
| `WSL introuvable` | WSL n'est pas installé. PowerShell admin : `wsl --install`, puis installe une distro Arch. |
|
||
| `pacman: signature unknown trust` | Keyring périmé → `pacman -Sy --noconfirm archlinux-keyring` puis relancer. |
|
||
| `makepkg: conflicting files` | `pacman -Syu` incomplet avant le build. Relancer `setup-calamares.sh`. |
|
||
| `mkarchiso` plante sur `[fws-local]` | Le repo local n'a pas été généré. Relancer `setup-calamares.sh`. |
|
||
| Calamares ne démarre pas dans l'ISO | Sur la VM, basculer en `tty2` (autologin root) et lancer `journalctl -b`. |
|
||
| `Calamares Initialization Failed: desktop@desktop` | Module mal configuré dans `settings.conf` — vérifier que la séquence utilise `packagechooser`, pas `desktop`. |
|
||
| `Variables manquantes : DESKTOP` | Les `$DESKTOP` dans `shellprocess.conf` sont interprétés par Calamares — utiliser une command substitution `$(cat /run/fws-desktop)` à la place. |
|
||
| Écran noir après login Hyprland | Tu testes dans VirtualBox → pas d'accélération GPU. Utiliser QEMU/KVM avec `virtio-gpu` ou bare-metal. |
|
||
| Retours à la ligne CRLF | `build.sh` lance `dos2unix` automatiquement, mais si tu modifies pendant le build, relancer. |
|
||
|
||
### Logs utiles
|
||
|
||
```bash
|
||
# Pendant le build
|
||
tail -f /tmp/fws-build/work/iso/arch/pkglist.x86_64.txt
|
||
|
||
# Dans l'ISO (autologin tty1)
|
||
journalctl -b
|
||
cat /var/log/Calamares.log
|
||
|
||
# Hyprland post-install
|
||
cat ~/.local/share/hyprland/hyprland.log
|
||
```
|
||
|
||
---
|
||
|
||
## Variables d'environnement supportées
|
||
|
||
| Variable | Effet | Défaut |
|
||
|---|---|---|
|
||
| `ARCH_WSL_DISTRO` | Nom de la distro WSL Arch | `Arch` |
|
||
| `MSYS_NO_PATHCONV` | Désactive la conversion auto des chemins Git Bash | `1` (forcé dans les scripts) |
|
||
|
||
---
|
||
|
||
## Licence & origine
|
||
|
||
FWS est un fork de **[archiso](https://gitlab.archlinux.org/archlinux/archiso)** (Arch Linux), redistribué sous les termes de la **GPL-3.0-or-later**.
|
||
|
||
Voir [LICENSE](LICENSE) pour le texte complet, et [AUTHORS.rst](AUTHORS.rst) pour la liste des auteurs originaux d'archiso.
|
||
|
||
Les modifications spécifiques à FWS (scripts `build.sh`, `setup-calamares.sh`, overlay `configs/baseline/`, intégration Calamares + Xorg autostart, chaîne de build WSL) sont également distribuées sous GPL-3.0-or-later.
|