{"id":15007207,"url":"https://github.com/murkl/arch-os","last_synced_at":"2025-10-29T06:20:38.706Z","repository":{"id":149511093,"uuid":"606905120","full_name":"murkl/arch-os","owner":"murkl","description":"Arch Linux • Vanilla • One File Distro • GNOME • Graphics Driver • Properties File Support • Intuitive Installer \u0026 Recovery","archived":false,"fork":false,"pushed_at":"2024-10-23T18:20:25.000Z","size":14881,"stargazers_count":34,"open_issues_count":2,"forks_count":4,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-10-24T00:43:02.136Z","etag":null,"topics":["amdgpu","arch-install-script","arch-installation","arch-linux-installation","archlinux","automation","bash","gnome","graphics-driver","intuitive","kiss","linux-distribution","minimal","nvidia-gpu","os","pipewire","shell-script","tui","vanilla","wayland"],"latest_commit_sha":null,"homepage":"https://bit.ly/arch-os","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/murkl.png","metadata":{"files":{"readme":"docs/README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-02-26T22:16:57.000Z","updated_at":"2024-10-17T00:17:49.000Z","dependencies_parsed_at":null,"dependency_job_id":"1dd12efa-d559-4a4e-9fd8-b727ab2c75ed","html_url":"https://github.com/murkl/arch-os","commit_stats":{"total_commits":225,"total_committers":2,"mean_commits":112.5,"dds":0.09333333333333338,"last_synced_commit":"2f214dce3e6847a7c9699af04487c5a75aecfeb8"},"previous_names":["murkl/arch-vanilla-os"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/murkl%2Farch-os","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/murkl%2Farch-os/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/murkl%2Farch-os/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/murkl%2Farch-os/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/murkl","download_url":"https://codeload.github.com/murkl/arch-os/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238960351,"owners_count":19559247,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["amdgpu","arch-install-script","arch-installation","arch-linux-installation","archlinux","automation","bash","gnome","graphics-driver","intuitive","kiss","linux-distribution","minimal","nvidia-gpu","os","pipewire","shell-script","tui","vanilla","wayland"],"created_at":"2024-09-24T19:05:27.573Z","updated_at":"2025-10-29T06:20:38.682Z","avatar_url":"https://github.com/murkl.png","language":"Shell","readme":"\u003ch1 align=\"center\"\u003e\n  \u003cimg src=\"./logo.svg\" width=\"150\" height=\"150\"\u003e\n  \u003cp\u003eArch OS\u003c/p\u003e\n\u003c/h1\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n\u003cp\u003e\u003cstrong\u003eBoot from latest \u003ca target=\"_blank\" href=\"https://github.com/murkl/arch-os/releases/latest\"\u003eArch OS ISO\u003c/a\u003e to launch the Installer automatically.\u003c/strong\u003e\u003c/p\u003e\n\n \u003cp\u003eAlternatively boot from official \u003ca target=\"_blank\" href=\"https://archlinux.org/download/\"\u003eArch Linux ISO\u003c/a\u003e and run\u003c/p\u003e\n\n**`curl -Ls bit.ly/arch-os | bash`**\n\n\u003cp\u003e\u003cb\u003e\n\n[➜ Step by Step Installation Guide](#arch-os-installation)\n\n\u003c/b\u003e\u003c/p\u003e\n\n\u003cp\u003e\u003cimg src=\"./screenshots/installer.png\"\u003e\u003c/p\u003e\n\n\u003cp\u003e\u003cb\u003e\n\n[➜ More Screenshots](#screenshots)\n\n\u003c/b\u003e\u003c/p\u003e\n\n\u003cp\u003eOptimized for \u003cb\u003eGaming, Emulation, Audio \u0026 Development\u003c/b\u003e\u003c/p\u003e\n\n\u003cp\u003e\nThis project aims to provide a mostly automized, minimal and robust Arch Linux base (minimal tty core or desktop), along with an easy-to-use and fast properties-file-based installer with error handling. Install a minimal Arch Linux core with optional features such as GNOME Desktop with Graphics Driver, Automatic Housekeeping, Zen Kernel, Fancy Shell Enhancement, preinstalled Paru as AUR Helper, enabled MultiLib, Bootsplash, System Manager and some more...\u003c/p\u003e\n\n## More Information\n\n\u003cp\u003e\n  \u003cimg src=\"https://img.shields.io/badge/MAINTAINED-YES-green?style=for-the-badge\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/License-GPL_v2-blue?style=for-the-badge\"\u003e\n\u003c/p\u003e\n\n**[➜ Arch OS Documentation](DOCS.md)**\u003cbr\u003e\n\u003cb\u003e\u003ca about=\"_blank\" href=\"https://t.me/archos_community\"\u003e➜ t.me/archos_community\u003c/a\u003e\u003c/b\u003e\n\n\u003cp\u003e\u003csub\u003e100% shellcheck approved\u003c/sub\u003e\u003c/p\u003e\n\n\u003c/div\u003e\n\n## Core Features\n\n- [Minimal Arch Linux](DOCS.md#minimal-installation) (~150 packages)\n- [Zen Kernel](DOCS.md#advanced-installation) (configurable)\n- [Swap](DOCS.md#swap) with zram-generator (zstd)\n- [Sole OS](DOCS.md#partitions-layout)\n- BTRFS Snapshot Support (Snapper, OverlayFS)\n- All-in-One password (encryption, root \u0026 user)\n- Multilingual Support\n- Filesystem btrfs or ext4\n- Bootloader: grub or systemd (auto updated)\n- Silent Boot (optional)\n- Systemd OOM (out-of-memory killer)\n- Pacman parallel downloads \u0026 eyecandy (optional)\n- Network Manager\n- SSD Support (fstrim)\n- Microcode Support (Intel \u0026 AMD)\n- Disabled Watchdog (optional)\n- UEFI only supported\n- [More Information...](DOCS.md#technical-information)\n\n## Desktop Features\n\n- [GNOME Desktop Environment](DOCS.md#recommendation) (optional with additional packages)\n- [Arch OS Slim Version](DOCS.md#example-installerconf) (GNOME Core Apps only)\n- [Graphics Driver](DOCS.md#install-graphics-driver-manually) (Mesa, Intel i915, NVIDIA, AMD, ATI)\n- [Pipewire Audio](DOCS.md#for-audiophiles) (Dolby Atmos supported)\n- Flatpak Support + Auto Update (GNOME Software)\n- Samba, Networking Protocol Libs, Git, Utils \u0026 Codecs included\n- GNOME Power Profiles Support (tuned-ppd)\n- VPN Support\n- Basic Fonts\n- Wayland optimized\n- Auto GNOME Login enabled\n- Printer Support (cups)\n- SSH Agent (gcr)\n- Gamemode preinstalled\n- No Xorg included\n\n## Additional Features\n\n- [Arch OS Core Tweaks](DOCS.md#core-tweaks)\n- [Arch OS Bootsplash](https://github.com/murkl/plymouth-theme-arch-os)\n- [Arch OS System Manager](DOCS.md#arch-os-manager)\n- [Arch OS Shell Enhancement](DOCS.md#shell-enhancement)\n- [Arch OS Starship Theme](https://github.com/murkl/starship-theme-arch-os)\n- [Arch OS Automatic Housekeeping](DOCS.md#housekeeping)\n- [AUR Helper](DOCS.md#advanced-installation) (configurable)\n- [VM Support](DOCS.md#vm-support) (optional)\n- 32 Bit Support (Multilib)\n- Disk Encryption (LUKS2)\n\n## Arch OS Installation\n\nTo install Arch OS, an internet connection is required, as many packages will be downloaded during the installation process.\n\n### 1. Prepare bootable USB Device\n\n- Download latest Arch OS ISO from **[GitHub](https://github.com/murkl/arch-os/releases/latest)**\n  - Alternatively, download official Arch Linux ISO from **[archlinux.org](https://www.archlinux.org/download)** or **[archlinux.de](https://www.archlinux.de/download)**\n- Use **[Ventoy](https://www.ventoy.net/en/download.html)** or your prefered iso writer tool to create a bootable USB device\n- Alternatively (Linux only): **[➜ Arch OS Creator](https://github.com/murkl/arch-os-creator)**\n\n### 2. Configure BIOS / UEFI Settings\n\n- Disable Secure Boot\n- Set Boot Mode to UEFI\n\n### 3. Boot from USB Device\n\n- Load prefered keyboard layout (optional): `loadkeys de`\n- Connect to WLAN (optional): `iwctl station wlan0 connect 'SSID'`\n\n#### 3.1. Run Arch OS Installer\n\n```\ncurl -Ls bit.ly/arch-os | bash\n```\n\n**Note:** _Cancel the Arch OS Installer with `Ctrl + c`. The properties will be restored upon the next execution._\n\n**[➜ See Advanced Installation](DOCS.md#advanced-installation)**\n\n## System Maintenance\n\n\u003cp\u003e\u003cimg src=\"./screenshots/manager_menu.png\"\u003e\u003c/p\u003e\n\nAfter installing Arch OS with the default properties preset, most maintenance tasks are performed automatically. However, the following steps must be executed manually on a regular basis:\n\n- Regularly upgrade your system packages (Pacman/AUR \u0026 Flatpak)\n- Regularly read the **[Arch Linux News](https://www.archlinux.org/news)** (preferably before upgrading your system)\n- Regularly check \u0026 merge new configurations with `pacdiff` (preferably after each system upgrade)\n- Consult the **[Arch Linux Wiki](https://wiki.archlinux.org)** (if you need help)\n\nTo streamline this process, you can use the preinstalled **[➜ Arch OS System Manager](https://github.com/murkl/arch-os-manager)**\n\nIf you need to rescue your Arch OS in case of a crash, boot from an **[Arch ISO Device](#1-prepare-bootable-usb-device)** and start the **[➜ Arch OS Recovery](https://github.com/murkl/arch-os-recovery)** with:\n\n```\ncurl -Ls bit.ly/arch-os-recovery | bash\n```\n\n\u003cdetails\u003e\n\n\u003csummary\u003e\u003ch2 style=\"display: inline;\" id=\"screenshots\"\u003eScreenshots\u003c/h2\u003e\u003c/summary\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003cp\u003e\u003cdiv\u003e\u003cimg src=\"./screenshots/desktop_overview.jpg\"\u003e\u003c/div\u003e\u003csub\u003e\u003ci\u003eDesktop Demo\u003c/i\u003e\u003c/sub\u003e\u003c/p\u003e\n  \u003cp\u003e\u003cdiv\u003e\u003cimg src=\"./screenshots/bootsplash.png\"\u003e\u003c/div\u003e\u003csub\u003e\u003ci\u003eBootsplash Demo\u003c/i\u003e\u003c/sub\u003e\u003c/p\u003e\n  \u003cp\u003e\u003cdiv\u003e\u003cimg src=\"./screenshots/starship.png\"\u003e\u003c/div\u003e\u003csub\u003e\u003ci\u003eStarship Demo\u003c/i\u003e\u003c/sub\u003e\u003c/p\u003e\n  \u003cp\u003e\u003cdiv\u003e\u003cimg src=\"./screenshots/fastfetch.png\"\u003e\u003c/div\u003e\u003csub\u003e\u003ci\u003eFetch Demo\u003c/i\u003e\u003c/sub\u003e\u003c/p\u003e\n  \u003cp\u003e\u003cdiv\u003e\u003cimg src=\"./screenshots/desktop_apps.png\"\u003e\u003c/div\u003e\u003csub\u003e\u003ci\u003eDesktop Core Apps Demo\u003c/i\u003e\u003c/sub\u003e\u003c/p\u003e\n  \u003cp\u003e\u003cdiv\u003e\u003cimg src=\"./screenshots/manager_dashboard.png\"\u003e\u003c/div\u003e\u003csub\u003e\u003ci\u003eSystem Manager Demo\u003c/i\u003e\u003c/sub\u003e\u003c/p\u003e\n  \u003cp\u003e\u003cdiv\u003e\u003cimg src=\"./screenshots/recovery.png\"\u003e\u003c/div\u003e\u003csub\u003e\u003ci\u003eBTRFS Recovery Demo\u003c/i\u003e\u003c/sub\u003e\u003c/p\u003e\n\u003c/div\u003e\n\n\u003c/details\u003e\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmurkl%2Farch-os","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmurkl%2Farch-os","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmurkl%2Farch-os/lists"}