Arch-Installer

An easy-to-use Arch-Linux installer written in Python
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents

• Table of Contents
• About The Project
  • Built With
• Getting Started
  • Prerequisites
  • Installation
• Configuration
• Usage
• Roadmap
• Contributing
• License
• Contact

About The Project

I often change operating system and I was tired of having to search every time one of the thousands of tutorials / guides on the internet on how to install arch-linux so I decided to create my own installer

For now it offers a very limited range of installation customizations, which are however sufficient to install a stable and working version of the operating system.

Built With

• Python3
• PyYAML

Getting Started

The followings are the steps for install Arch with this tool.

Prerequisites

1. Download the Arch-Linux ISO from the official website
2. Make a bootable USB with the ISO
3. Boot the ISO

Installation

1. Install git

pacman -Syy git

2. Clone the repo

git clone https://github.com/alemazzo/archinstaller

3. Change directory

cd archinstaller

Configuration

1. If you want to make the partitions by yourself this is the moment. Otherwise use the format.sh script for erase all the disk and create a unique partition for the os.

# This will delete all your data

# Make the script executable
chmod +x format.sh 

# Execute the script
./format.sh

2. Start editing the configuration

nano config.yml

3. Manage the settings in the accounts section and set the root's password and the data for the base account.

accounts:
  root-password: root
  username: alessandro
  password: password

4. Manage the settings section for your system setup.

settings:
  ntp: true
  keymap: it
  locale: en_US.UTF-8 UTF-8
  lang: en_US.UTF-8
  region: Europe
  location: Rome
  hostname: Matebook

5. Manage the packages section (do not touch the required packages).
   You can add the packages that you want in your system but i suggest you to install them once the system is already installed and not during the installation.

packages:
  # Required packages
  ...

  # Window Managment
  - xorg
  - kde-applications
  - plasma
  - plasma-wayland-session

  # You can add other stuff here

Usage

1. Make the script executable

chmod +x installer.py

2. Execute the installer

./installer.py config.yml

Roadmap

See the open issues for a list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

Contact

Alessandro Mazzoli - @alessandro.py - [email protected]

Project Link: https://github.com/alemazzo/ArchInstaller