Uninstallation & Recovery¶

Pimarchy is designed to be fully reversible. If you need to revert your Raspberry Pi to its original state, follow these steps.

The `uninstall.sh` Script¶

The uninstall.sh script is the primary tool for removing Pimarchy. It handles several key tasks:

Backs up current configs: Before making changes, it creates a final snapshot of your configuration.
Restores original backups: It looks for the .original-backup marker and restores your pre-Pimarchy configurations to ~/.config/.
Removes packages (Optional): You will be prompted to choose whether to remove the packages installed by Pimarchy.
Reverts Boot Settings: It removes the overclocking and performance settings from /boot/firmware/config.txt.
Disables Greetd: It disables the login manager and reverts the system to a standard TTY console login.

How to Uninstall¶

Navigate to your pimarchy directory:
```
cd ~/pimarchy
```
Run the uninstaller:
```
bash uninstall.sh
```
Follow the interactive prompts:
- Remove packages? (y/N) — If you select y, Hyprland, Waybar, Alacritty, and other packages will be removed.
- Remove Docker? (y/N) — Choose whether to remove Docker and its repositories.
- Remove OpenCode? (y/N) — Choose whether to remove the OpenCode AI agent.
Final Reboot:
```
sudo reboot
```

Manual Recovery¶

If for some reason uninstall.sh fails, you can manually revert your system:

1. Disable Greetd¶

sudo systemctl disable greetd
sudo systemctl enable getty@tty1

2. Remove CPU Performance Mode¶

Edit /boot/firmware/config.txt and remove the following lines:

# PIMARCHY PERFORMANCE MODE
arm_freq=2600
# or
governor=performance

3. Restore Backups¶

Your original configurations are stored in ~/.config/Pimarchy-backup/original/. You can copy them back to ~/.config/.

cp -r ~/.config/Pimarchy-backup/original/* ~/.config/

Need a Fresh Start?¶

If you want to completely wipe Pimarchy and start over, the fastest way is to re-flash your MicroSD card with a fresh copy of Pi OS Lite using the Raspberry Pi Imager.