Etxe

Etxe aims to be a friendly Arch Linux configuration for non-technical users. The goal of this project is to make Linux actually approachable for everyone, going the extra mile to make a solid operating system with as little compatibility issues as possible.

ISO

Build a test ISO with:

sudo ./iso/build.sh

By default, the ISO bundles the native package repository, the AUR packages listed in packages/aur.pkglist, and the Flatpak system apps listed in packages/flatpak.pkglist. AUR package bundling uses devtools to build packages in a clean chroot. For a smaller development ISO without those offline assets, use:

sudo SKIP_OFFLINE_REPO=YES ./iso/build.sh

Create a bootable USB drive from an ISO in iso/out/ with:

./iso/create-usb.sh

Updates

Update an already installed Etxe system from a current checkout with:

sudo ./update.sh

The updater only runs on systems branded as Etxe unless ETXE_UPDATE_FORCE=YES is set. It refreshes Etxe-owned configuration, installed Etxe GNOME extensions, installed Etxe apps, branding, systemd-boot when present, and the local updater payload. It does not run pacman, build AUR packages, update Flatpaks, reinstall package-manifest entries the user removed, or install newly added default apps. Package manifests under packages/ are install-time defaults only. It logs to /var/log/etxe-update.log, copies the current update payload to /opt/etxe, and installs /usr/local/bin/etxe-update for future local runs plus /usr/local/bin/etxe-update-latest and /usr/local/bin/etxe-update-status for GitHub-backed updates. New installs also receive those updater commands during installation.

Installed systems periodically check GitHub for updates and show an update button in GNOME Quick Settings when a newer Etxe revision is available. The button opens Etxe Update, which can check GitHub, report whether the system is up to date, and run the update with progress and logs.

Run the latest updater from GitHub with:

sudo etxe-update-latest

For a VM reachable over SSH, copy the current checkout and run the updater with:

./iso/update-vm.sh user@127.0.0.1 2222

Use the username, host, and port for your VM. VMs created with ./iso/create-vm.sh --3d normally use host 127.0.0.1 and port 2222. SSH must be enabled in the VM first with sudo pacman -S --needed openssh && sudo systemctl enable --now sshd.