Stuck at Installing Omarchy using wget? A Troubleshooting Guide

[sailoz]

Stuck at Installing Omarchy using wget? A Troubleshooting Guide

When you are stuck and nothing shows when you do

wget -qO- https://omarchy.org/install | bash

If you're encountering issues with the automatic installation script for Omarchy, this guide provides a step-by-step approach to diagnose and resolve the problem. The primary installation method for Omarchy, an opinionated Arch/Hyprland setup, involves a simple wget command. However, if that fails, network connectivity or other issues might be the cause.

---

Step 1: Test Your Network Connectivity

First, verify your internet connection by pinging a reliable public DNS server.

ping -c 5 1.1.1.1

If this command fails, it indicates a problem with your general network connection. Please check your network cables, Wi-Fi connection, and router configuration.

---

(Optional) Step 2: Check your network is IPv6 Ready

Using devices (phone , tablet, or another PC etc) in same WiFi network, test your network is IPv6 ready

1. Open following website to test IPv6 readiness.
   This is no strictly neccesary but IPv6 ready seems to make downloading packages from Arch Linux sites makes smoother.

   https://test-ipv6.com/

---

Step 3: Check Connection to Omarchy.org

If your general network connection is working, the next step is to test connectivity specifically to the Omarchy server.

1. Test IPv6 Connection:

   ping -6 -c 5 omarchy.org

2. Test IPv4 Connection (if IPv6 fails):
   If the IPv6 ping fails, test the connection using IPv4.

   ping -4 -c 5 omarchy.org

---

Step 4: Use relflector command to pick Arch Linux package mirror cloer and faster for your locaton.

You might see lots of errors using reflector command.
It is normal as this commands check some unavilable mirrors and pick better for you.

This could save your time later when installing Omarchy and package update in normal days.

Optionally, you could run reflector in normal days once in a 2 weeks or a month to update your mirrorlist.

sudo pacman -S reflector

sudo reflector --protocol https,http --score 20 --sort rate --save /etc/pacman.d/mirrorlist

---

Step 5: Attempt Installation via IPv4

If the IPv4 ping to omarchy.org was successful, you can try to force the installation script to use IPv4 with the following command:

wget -4 -qO- https://omarchy.org/install | bash

---

Step 6: Manual Installation via Git

If the previous steps did not resolve the issue, you can perform a manual installation using Git. This is a reliable alternative if you are still unable to download the installation script directly. Omarchy is designed for Arch Linux, and these commands are tailored for that environment.

1. Install Git:
   Ensure you have git installed on your system. pacman is the package manager for Arch Linux.

   sudo pacman -Sy git

2. Clone the Omarchy Repository:
   Download the Omarchy source code from its official GitHub repository.

   git clone https://github.com/basecamp/omarchy ~/.local/share/omarchy

3. Run the Installation Script:
   Two options:

   a. Option 1 - full install
   Finally, execute the installation script located within the cloned repository.

   ~/.local/share/omarchy/install.sh

   b. Option 2 - install-bare
   Without a few fonts and software in install/xtra.sh
   Finally, execute the installation script located within the cloned repository.

   export OMARCHY_BARE=true
   ~/.local/share/omarchy/install.sh

By following these steps, you should be able to successfully install Omarchy, even if the initial wget command fails.

[sailoz]

TODO

DONE
8/17

• install-bare missing - added
• simplify git clone to a command - done

8/18

• included test-ipv6 website to check IPv6 readiness
• included steps to use reflector to update mirrorlist of Arch Linux packages, to speed up Omarchy install and daily yay package updates
  (this does not speed up AUR as AUR does not have mirror(s). )