Hyprnux Install Français

Install Hyprnux

Hyprnux installs on an Arch Linux you already have, from a terminal: you add the Hyprnux repository once, then install the parts you want.

  • pacman packages
  • Signed packages
  • From source on other distributions

Which path?

  • An Arch Linux you already have

    Follow the steps below, from a terminal. This is the way to install Hyprnux today. You need Arch and a terminal to install it; using it needs neither.

  • Another distribution

    Build the packages from their sources: the PKGBUILD of each package (its package recipe), in the source repository, lists the steps. Only pacman packages are published.

  • A computer with no Linux yet

    Not available

    A graphical installer image is built but not published, so installing Linux for the first time is not a path this page can give you.

In short

Five steps: check what you have, add the repository, install, start it and, if you want it, switch the login screen. Packages are signed, and you check the key before you trust it.

On a machine set up from the Hyprnux installer image, every edition also has the encrypted disk, the firewall and secure time sync. On your own Arch you get the signed packages and set up the rest yourself.

New to Arch?

pacman is Arch’s software installer. A repository is a software source it reads from. You add the Hyprnux repository once, then install packages from it like any other.

  1. Check what you have

    Arch Linux with systemd. pacman comes with Arch.

    Requirements: an x86_64 PC, hyprland 0.56 or newer (the window manager) and quickshell 0.3 or newer (the toolkit the bar is drawn with), both from the Arch repositories. Hyprnux’s own packages come from the Hyprnux repository.

  1. Add the Hyprnux repository

    Once per machine. First get the repository key and look at it:

    curl -fsSLO https://www.hyprnux.org/hyprnux.gpg gpg --show-keys hyprnux.gpg

    The line under pub must read BF3FA18AE63F226028A83A2E3DA59F85B9821E2C If it does not, stop. Then tell pacman to trust the key:

    sudo pacman-key --add hyprnux.gpg sudo pacman-key --lsign-key BF3FA18AE63F226028A83A2E3DA59F85B9821E2C

    Then add this block to /etc/pacman.conf, above the line [core], once. The first repository that has a package wins, so Hyprnux’s own packages are found first. SigLevel = Required DatabaseRequired makes pacman refuse any package or database from this repository without a valid signature:

    [hyprnux-core] SigLevel = Required DatabaseRequired Server = https://repo.hyprnux.org/$repo/os/$arch

    This is the Community edition’s repository, which follows Arch closely.

    Or add it from the terminal

    Run this line instead of editing the file. It adds the block above [core] only if it is not there yet:

    grep -q '^\[hyprnux-core\]' /etc/pacman.conf || sudo sed -i '/^\[core\]/i [hyprnux-core]\nSigLevel = Required DatabaseRequired\nServer = https://repo.hyprnux.org/$repo/os/$arch\n' /etc/pacman.conf

  2. Install

    If Hyprland already loads a hyprglass plugin, remove its line from your Hyprland configuration first: two copies can crash Hyprland. Then log out and run the install from a text console, opened with Ctrl + Alt + F3: a running Hyprland may reload its config during the install.

    The whole desktop in one command, for a computer installed from the Hyprnux image or one that already uses dracut. On an Arch with mkinitcpio and an encrypted disk, take the minimal install below. hyprnux-edition-community names the edition; without a name, pacman asks.

    sudo pacman -Syu hyprnux-desktop hyprnux-edition-community
    What it changes

    pacman turns nothing on: the login screen stays off until you switch to it (see “Optional: switch to the Hyprnux login screen” below). A firewall or clock service you already run (nftables, chronyd) loads Hyprnux’s settings at its next start, and /etc/os-release becomes Hyprnux’s. The install guide lists everything to know before you run it.

    The five packages most people want, in one command. hyprnux-keyring keeps the repository key up to date:

    sudo pacman -Syu sudo pacman -S hyprnux-keyring hyprnux-shell \ hyprnux-settings hyprglass hyprnux-hyprland

    Or only some: name the packages you want from the list below. Settings is the easiest place to start. An update is sudo pacman -Syu.

    PartPackageGood to know
    Repository keyhyprnux-keyringHolds the key the Hyprnux repository signs with, and keeps it up to date.
    The shellhyprnux-shellThe desktop shell: the bar, the launcher and the panels. It brings hyprnux-palette, which makes the color scheme from the wallpaper.
    Settingshyprnux-settingsInstalls on its own. It does not need the shell.
    HyprglasshyprglassThe glass effects plugin. Read the note above the command if your Hyprland already loads one.
    Hyprland configurationhyprnux-hyprlandThe configuration an account gets when it has no hyprland.lua of its own.
    The login screenhyprnux-loginOptional, not in the command above. You have to switch by hand from sddm (or gdm) to greetd.
    First starthyprnux-firstbootOptional, not in the command above. Only the Hyprnux installer turns it on, so on your own Arch it has no visible effect, and it adds dracut. On a new computer it asks a few questions, such as the language and the keyboard, then creates the first account. If your Arch uses mkinitcpio, read the note on mkinitcpio.

  3. Start it

    Log out, choose the Hyprland session on your login screen and sign in. With the shell installed, the bar and the launcher appear.

    The session is the entry the hyprland package adds. To go back, log out and choose your previous session again.

  4. Optional: switch to the Hyprnux login screen

    This step replaces your current login manager, and the other parts work without it. Before you switch, move what you keep in ~/.zshenv or ~/.zprofile to environment.d or to Hyprland’s own environment, because greetd, the program that handles logins and starts your session, reads only /etc/profile and ~/.profile at login.

    Once per machine. You have to switch by hand from sddm (or gdm) to greetd: install hyprnux-login, disable your current login manager, sddm or gdm, whichever is enabled, then enable greetd. The command below names sddm: write gdm instead if that is the one enabled. It takes effect at the next boot.

    sudo pacman -S hyprnux-login sudo systemctl disable sddm sudo systemctl enable greetd

Pick an edition

The steps above set up the Community edition, which follows Arch closely. Pro and Enterprise are the same desktop with other update and security policies: Compare them on the Editions page, or read the full guide to see what each one changes. Today only Community can be installed: Pro and Enterprise machines start from the Hyprnux installer image, which is not published.

For experts

Using it with your own configuration

An account without its own ~/.config/hypr/hyprland.lua gets the Hyprnux configuration: there is nothing to add. A file of your own stays as it is: add the lines for what you installed, once. Keep only one line that loads hyprglass.

GoalPackagesWhat to add
The shell only
hyprnux-shell
require("/usr/share/hyprnux/shell/hyprland/hyprnux-shell")
The shell and Hyprglass
hyprnux-shell, hyprglass
hl.plugin.load("/usr/lib/hyprglass/hyprglass.so")require("/usr/share/hyprnux/shell/hyprland/hyprnux-shell")
The whole Hyprnux Hyprland configuration
hyprnux-hyprland
require("/usr/share/hyprnux/hyprland/hyprland")
Settings only
hyprnux-settings
Nothing.

With hyprnux-hyprland, the shell and Hyprglass load by themselves: add no other line for them. The shell’s line does nothing if its file is already loaded.

About the repository

None of the packages declares replaces, so none takes over an Arch package. Two declarations exist: hyprnux-login provides greetd-greeter, the generic name of a greetd login screen, and hyprnux-shell conflicts with two older Hyprnux helper packages.

To see what the repository holds:

pacman -Sl hyprnux-core
Install from package files

If you were handed Hyprnux package files, put them in one folder and give pacman every file at once, so the packages that depend on each other resolve together:

sudo pacman -U hyprnux-shell-*.zst hyprnux-settings-*.zst hyprglass-*.zst \ hyprnux-hyprland-*.zst hyprnux-palette-*.zst

If one of the files is hyprnux-keyring, check it before you install it. The install guide also says how to build the files yourself. The login screen and the first-start assistant are added the same way when you want them (hyprnux-login-*.zst, hyprnux-firstboot-*.zst).

Remove

After a complete install, first enable your previous login manager again if you switched to greetd and run sudo systemctl disable greetd.service. Then remove the desktop and the packages installed for it. /etc/os-release stays Hyprnux’s until sudo pacman -S filesystem puts Arch’s back:

sudo pacman -Rns hyprnux-desktop

After a minimal install, this removes the five parts and the color palette. If you installed the login screen or the first-start assistant, add hyprnux-login and hyprnux-firstboot to the command (pacman stops on a name that is not installed). Leave out the packages you want to keep.

sudo pacman -Rns hyprnux-shell hyprnux-settings hyprglass \ hyprnux-hyprland hyprnux-palette hyprnux-keyring

Remove hyprnux-login only after enabling another login manager, or the machine boots to a text console. The install guide shows how to go back to your previous one, under “Add the login screen”.

If you added lines to your own hyprland.lua (see Using it with your own configuration), delete them: they point to files that are gone.

Your files in your home folder, such as ~/.config/hyprnux, stay. Delete them yourself if you no longer want them.

Remove the repository

Delete the [hyprnux-core] block from /etc/pacman.conf, then remove the key from pacman:

sudo pacman-key --delete BF3FA18AE63F226028A83A2E3DA59F85B9821E2C

If you are stuck