Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/novaandrom3da/anarchy-installer

Last synced: 21 days ago
JSON representation

Host: GitHub
URL: https://github.com/novaandrom3da/anarchy-installer
Owner: NovaAndrom3da
License: gpl-2.0
Created: 2022-11-16T02:48:30.000Z (about 2 years ago)
Default Branch: main
Last Pushed: 2022-11-16T02:56:34.000Z (about 2 years ago)
Last Synced: 2024-04-18T10:17:21.369Z (9 months ago)
Language: JavaScript
Size: 1.38 MB
Stars: 1
Watchers: 2
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE

Awesome Lists containing this project

README

![Anarchy Installer's banner](assets/banner.svg)

[![All Contributors](https://img.shields.io/badge/all_contributors-67-orange.svg?style=flat-square)](#contributors-)

# Revived project

**Unfortunately, it is time to put an end to the project. It was several years being one of the maintainers of Anarchy and in which time I tried to bring more stability and new improvements to it. But it is also true that Arch Linux (and particularly archiso) development is in constant motion, which forces independent installer developers to keep up with all the changes and never fall behind. Personally, I don't have time for that and I don't want to fail the community by pretending to be the maintainer of a project that I haven't spent time on for a long time.**

**However, I do not disappear. I am developing an installer that takes many features from Anarchy, as well as from other installers like Manjaro Architect or Anaconda. For now it's a personal project, which advances at the pace I want to give it. You are invited.**

**That's why I'm not saying goodbye, but see you soon.**

**Panda Foss**

Hello! I am working on some **big** updates! This is a fork of the original anarchy installer, but will include various other features (to come). There are several ideas for this software I have gained after using it for the last several months, such as automatically updating pacman's (the package manager's) GPG keys, which I have seen many issues on the original GitLab repository related to it. One simple fix I have been using has been dropping to the terminal, and running this:
```bash
nmtui; timedatectl set-ntp true; pacman -Sy archlinux-keyring; anarchy
```
This is so I can connect to the internet from Wi-Fi enabled systems, make sure the time and date of the OS are correct (pacman fails to properly check the validity of packages if the package developers' GPG keys were "created too far in the future".)

I am looking forward to fixing up this amazing software. :)

**Froggo**

# About

Anarchy is a simple and intuitive Terminal based (TUI) [Arch Linux](https://archlinux.org) installer.
It guides you through every aspect of the installation procedure, from partitioning to installing your favorite DE/WM.

**Currently [anarchyinstaller.gitlab.io](https://anarchyinstaller.gitlab.io) is the only official website for Anarchy, do NOT download releases from other sites.
You can also directly download latest releases using the [Releases](https://gitlab.com/anarchyinstaller/installer/-/releases) section on our Gitlab, which will lead
you to OSDN.**

## Installation

### Linux

The easiest way to flash Anarchy onto a USB drive is to use `dd`:

```sh
# Do NOT copy and paste the following, manually type the command, filling in the appropriate information
# Replace sdx with the name of your USB
dd if=anarchy--.iso of=/dev/sdx status=progress conv=sync
```

If you're more comfortable with GUI-based programs, you can use [Etcher](https://www.balena.io/etcher/) or
GNOME Disks (Restore image option).

### Windows

Use [Win32DiskImager](https://sourceforge.net/projects/win32diskimager/) or [Rufus](https://rufus.ie/).

### Install via SSH

_Keep in mind that running the installer over an SSH connection requires physical access to the remote machine._

After flashing Anarchy on a USB drive, it must be booted from the machine where you want to install.
If it has a wired internet connection, you only have to wait approximately one minute for Anarchy to start before
connecting.
If you have a wireless connection, you have two options: you normally connect to the target machine
(requires physical access), or you must compile the installer yourself as indicated in the next step, but adding the
file `autoconnect.sh` (it must be kept exactly the same name) along with the script `build.sh`.
The `autoconnect.sh` file must have the following format:

```sh
SSID="your_wifi_network_ssid"
PASSWORD="your_wifi_network_password"
PUBLIC_KEY=/path/to/your/public/key
```

`SSID` must contain the name that identifies the wifi network, `PASSWORD` is its respective password, and `PUBLIC_KEY`
refers to the local path of our public SSH key.
Then you can compile the installer normally.
To connect simply run on your local machine (from where you will install via SSH): `ssh [email protected]`
The default password is `anarchy`.

## Compiling the installer

You have two options for compiling the installer:

- If on Arch Linux: run `build.sh -a x86_64` with root permissions (e.g. with `sudo`) to build a 64-bit ISO image or run `build.sh -a i686` in case you want to build a 32-bit iso image (the latter option is based on the [Arch Linux 32](https://www.archlinux32.org/) project)
- If elsewhere: run `build.sh -c`, which will build it with `podman` in a container

You can also manually build Anarchy using the `Containerfile` with your preferred arguments.

Finally, you can use the `-h` (or`--help``) option to see other available options:

```sh
Usage: ./build.sh [options]
Options:
-c, --container Create Anarchy in a container using podman (only for 'x86_64' architecture).
-a, --arch Generates the ISO with the specified architecture ('x86_64', 'i686' or 'both').
-p, --purge Remove build artefacts.
-k, --keep Retain the packages, mirrorlist and other things required to build the 32-bit ISO.
-h, --help Display this help message and exit.
```

__Warning:__ While the build script supports the generation of 64-bit and 32-bit ISO images, __it was designed to be run on a 64-bit machine only__. Possibly on a 32-bit machine it may only allow 32-bit ISO generation, but ___this has not been tested yet___.

## Reporting issues

Before [reporting an issue](https://gitlab.com/anarchyinstaller/installer/issues) do the following:

- Make sure you're using the latest version of Anarchy
- Write down the log's automatically generated url (e.g. *termbin.com/xywz*)
- If it's a post-install issue check the [Arch Wiki](https://wiki.archlinux.org/) and existing posts on the
[Arch Forums](https://bbs.archlinux.org/), since it's most likely an Arch-related issue and not connected to Anarchy
(**Don't ask for support on the forums, they rightfully don't support downstream distributions - Ask on our Telegram**)

If the installer stops responding, but doesn't report an error (e.g. stuck at the progress bar), you can force quit by
pressing `CTRL+C`, then in the terminal you can manually run `nc termbin.com 9999 < /root/anarchy.log` (usually
the installer will upload a log automatically).
Then share the link you got as a response in the terminal.

If you don't want to sign up for Gitlab, you can also report issues
[over email](mailto:incoming+anarchyinstaller-installer-18524601-issue-@incoming.gitlab.com).

## Contributing

We're always looking for new contributors to the project, so check out our [contributing guide](CONTRIBUTING.md)
for more info.

## Contributors ✨

Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):

_{Dylan James}
💻 🤔

_{Erazem Kokot}
💻 🤔 🚇 🖋 🚧 🌍

_condor2
💻 🤔

_{David C. Drake}
💻

_{Avinash Reddy}
💻

_{Alexandre Wurtz}
💻

_{Frederic Bezies}
💻 🌍

_{Max Ferrer}
💻 🤔 🎨 🖋 🚧 🌍

_{Plamen Nedkov}
💻

_Badaboum
💻 🌍

_{Fábio Nogueira}
🌍

_Michael
💻 🌍

_{Danil Antoshkin}
🌍

_{viviengraffin}
💻 🌍

_Kaobear
💻

_Uyuiyu
🌍

_{Miris Wisdom}
💻 🖋

_Yosh
💻 🖋

_{Isaac A.}
💻

_Arsenijs
💻

_{Andrew Grechkin}
💻

_Firminator
💻

_{Fredrik Teschke}
💻

_m00ny
💻

_herobrauni
💻

_{Malte Grave}
💻

_Tautvydas
🌍

_phenri
🌍

_{Robson Silva}
💻

_{John Brewer}
💻

_{Xiang Fan}
💻

_{Oscar Holst}
🌍

_{Remisa Yousefvand}
💻

_includes08
🌍 💻

_Stanislas
💻

_{Geoffrey McClinsey}
🖋

_UNIcodeX
💻

_mikunimaru
💻

_W3ndige
🌍

_{Filis Futsarov}
🖋

_dszryan
💻

_Bakasura
🌍

_Michael
🌍

_{Marcelo Fern}
💻

_Nornort
💻

_{François F.}
🌍

_efreeking
🌍

_{Nemanja Nedeljković}
💻

_{Antoine Gravelot}
💻

_{Patrick Byrne}
💻

_Guruprasad
💻

_{Fan YANG}
💻

_{Renato Lacerda}
🌍

_liyiheng
💻

_{jorgeluiscarrillo}
🌍

_smac89
🖋

_{Jack Napier}
💻

_Jakub
🌍

_{Petr Severa}
💻 🌍

_Deiki
🌍

_{Michael Gilchrist}
💻

_{James Stronz}
💻

_{Rihards Skuja}
💻

_satory-ra
💻

_{Jonathan Córdova}
💻

_Bond-009
🌍

_{Neo Twenty-Nine}
⚠️ 💬