From 087354d5caaf60cf746ba93a71452faca9f4e78c Mon Sep 17 00:00:00 2001 From: Vaxry Date: Tue, 28 Jan 2025 18:48:14 +0000 Subject: [PATCH] installation: add callout about using git branches --- pages/Getting Started/Installation.md | 25 +++++++++++++++---------- 1 file changed, 15 insertions(+), 10 deletions(-) diff --git a/pages/Getting Started/Installation.md b/pages/Getting Started/Installation.md index 557d1701..026b948b 100644 --- a/pages/Getting Started/Installation.md +++ b/pages/Getting Started/Installation.md @@ -40,14 +40,19 @@ might have **major** issues running Hyprland. ## Installation -Installing Hyprland is very easy. Simply install it with your package manager -(if there is a Hyprland package available) or install/build it yourself. +Installing Hyprland is very easy. Simply install it with your package manager. -{{< callout >}} +{{< callout type=warning >}} + +It is **heavily** recommended you use **what the distro packages for you**, and **not** compiling manually +or using `-git` packages. +Hyprland's ecosystem and dependencies change often, and compiling manually will only potentially expose you to outdated, +or incompatible versions of these dependencies. + +If you get `.so` file mismatch / missing errors, it's _entirely your fault_ for doing this! -This project is under development and is constantly changing. If you want to -keep up to date with the latest commits, please consider updating your packages -with `yay -Syu --devel`, or your preferred package manager. +However, if you are an experienced user and want to beta-test new features, you're more than welcome to run the latest +git head. Please don't come asking about ".so file missing" errors though! {{< /callout >}} @@ -58,16 +63,16 @@ from source first. {{% details title="Arch" closed="true" %}} -Install from the AUR, which compiles the latest source: +Install a tagged release from the arch packages: ```shell -yay -S hyprland-git +sudo pacman -S hyprland ``` -or a tagged release from the arch packages: +or install from the AUR, which compiles the latest source: ```shell -sudo pacman -S hyprland +yay -S hyprland-git ``` Alternatively, install the `hyprland-meta` package to automatically fetch and compile the latest git versions of all components within the hypr* ecosystem.