From 8c0ebce5af54983da1623408ac886976021d91d9 Mon Sep 17 00:00:00 2001
From: Sean Zellmer <sean@lejeunerenard.com>
Date: Thu, 29 May 2025 17:35:25 -0500
Subject: [PATCH] Add `libatomic1` as dependency for ubuntu install (#175)

* Add `libatomic1` as dependency for ubuntu install

* Move libatomic install instructions up and include `yum` instruction

* Add `dnf`, `apk` & `pacman` instructions for `libatomic` requirement

Mirrors the error when running `pear-cli` without `libatomic` installed.
---
 guide/getting-started.md | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/guide/getting-started.md b/guide/getting-started.md
index fbc862a..f444448 100644
--- a/guide/getting-started.md
+++ b/guide/getting-started.md
@@ -10,6 +10,38 @@ Since `npm` (or equivalent package manager) is needed to install application dep
 
 Pear runs on Windows, Mac and Linux.
 
+Linux requires the `libatomic` library which can be installed using:
+
+Debian/Ubuntu:
+
+```console
+sudo apt install libatomic1
+```
+
+RHEL/CentOS:
+
+```console
+sudo yum install libatomic
+```
+
+Fedora:
+
+```console
+sudo dnf install libatomic
+```
+
+Alpine Linux:
+
+```console
+sudo apk add libatomic
+```
+
+Arch Linux:
+
+```console
+sudo pacman -S libatomic_ops
+```
+
 The `pear` CLI can be installed from [npm](https://www.npmjs.com/), which comes with [`node`](https://nodejs.org/en/about).
 
 The `npm` package manager can also be used to install application dependencies later on.