Skip to content

Getting started

From a fresh install to your setup

Three steps: add the repo, get the scripts, run the orchestrator. Everything is plain Bash — read it, judge it, and run only what you want.

Before you begin

  • • A working Arch-based or supported Linux install (see supported distros).
  • • Basic Linux familiarity — you should be comfortable in a terminal.
  • • These scripts are meant to be examined and run at your own discretion. Read before you run.

1 Add the nemesis_repo

The repo is signed with the Kiro key, so it inherits pacman's global SigLevel = Required — no per-repo override. The helper script trusts the key, installs kiro-keyring + kiro-mirrorlist, and adds the repo — backing up your /etc/pacman.conf first:

curl -sL bit.ly/nemesis-repo | sudo bash

Once set up, your /etc/pacman.conf holds the repo via the mirrorlist shipped by kiro-mirrorlist:

[nemesis_repo]
Include = /etc/pacman.d/kiro-mirrorlist
Prefer to do it by hand?

The mirrorlist file doesn't exist until kiro-mirrorlist is installed, so bootstrap with a direct Server line first. Add to /etc/pacman.conf:

[nemesis_repo]
Server = https://erikdubois.github.io/$repo/$arch

Then trust the Kiro signing key and install the keyring + mirrorlist:

sudo pacman -Sy
sudo pacman-key --recv-keys 149ABD0C3A0563EE --keyserver keyserver.ubuntu.com
sudo pacman-key --lsign-key 149ABD0C3A0563EE
sudo pacman -Sy --needed kiro-keyring kiro-mirrorlist

You can then swap the Server line for Include = /etc/pacman.d/kiro-mirrorlist to match the block above.

2 Get the scripts

Clone the repository and step into it:

git clone https://github.com/erikdubois/arcolinux-nemesis.git && cd arcolinux-nemesis

3 Run the orchestrator

0-current-choices.sh is the main entry point. It detects your OS, configures repos, updates the system, runs any distro-specific fixups, then runs the numbered pipeline.

bash 0-current-choices.sh
How the pipeline works

Good to know

Pick your steps

Enable or disable a step by commenting or uncommenting its line in 0-current-choices.sh. The numbering defines the order.

Step through it

Run with DEBUG=true to pause before each section for inspection:

DEBUG=true bash 0-current-choices.sh

Backups by default

Originals are saved with a .nemesis suffix before anything is overwritten — pacman.conf, mirrorlist, and more.

Next: choose a desktop

Thirteen desktops and window managers, one script each.

Browse desktops