![]() |
6 months ago | |
---|---|---|
.gitlab/issue_templates | 2 years ago | |
assets | 2 years ago | |
contrib | 1 year ago | |
src | 6 months ago | |
tests | 1 year ago | |
.all-contributorsrc | 1 year ago | |
.editorconfig | 2 years ago | |
.gitattributes | 2 years ago | |
.gitignore | 1 year ago | |
.shellcheckrc | 2 years ago | |
CONTRIBUTING.md | 1 year ago | |
Containerfile | 2 years ago | |
LICENSE | 2 years ago | |
README.md | 1 year ago | |
build.sh | 1 year ago | |
profiledef.sh | 9 months ago |
README.md
About
Anarchy is a simple and intuitive Terminal based (TUI) Arch Linux installer. It guides you through every aspect of the installation procedure, from partitioning to installing your favorite DE/WM.
Currently 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 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
:
# 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-<version>-<architecture>.iso of=/dev/sdx status=progress conv=sync
If you're more comfortable with GUI-based programs, you can use Etcher or GNOME Disks (Restore image option).
Windows
Use Win32DiskImager or Rufus.
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:
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 root@ip.address.of.target
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. withsudo
) to build a 64-bit ISO image or runbuild.sh -a i686
in case you want to build a 32-bit iso image (the latter option is based on the Arch Linux 32 project) - If elsewhere: run
build.sh -c
, which will build it withpodman
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:
Usage: ./build.sh [options]
Options:
-c, --container Create Anarchy in a container using podman (only for 'x86_64' architecture).
-a, --arch <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 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 and existing posts on the Arch Forums, 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.
Contributing
We're always looking for new contributors to the project, so check out our contributing guide for more info.
Contributors โจ
Thanks goes to these wonderful people (emoji key):
This project follows the all-contributors specification. Contributions of any kind welcome!
License
The project is licensed under the GNU GPLv2 license.