aboutsummaryrefslogtreecommitdiff
path: root/docs/wiki/Getting-Started.md
diff options
context:
space:
mode:
authorIvan Molodetskikh <yalterz@gmail.com>2025-11-10 22:50:32 +0300
committerGitHub <noreply@github.com>2025-11-10 22:50:32 +0300
commit978c4e6c8afc0199e2cbd9037bdc7c41fbbab2a3 (patch)
treee3065da07a991010ac5014c5ff31c389aa7dd4cd /docs/wiki/Getting-Started.md
parent9b11e39890867976e4b26590cf5de085163e3ff6 (diff)
downloadniri-978c4e6c8afc0199e2cbd9037bdc7c41fbbab2a3.tar.gz
niri-978c4e6c8afc0199e2cbd9037bdc7c41fbbab2a3.tar.bz2
niri-978c4e6c8afc0199e2cbd9037bdc7c41fbbab2a3.zip
wiki: Add quick start to Getting Started
Diffstat (limited to 'docs/wiki/Getting-Started.md')
-rw-r--r--docs/wiki/Getting-Started.md23
1 files changed, 23 insertions, 0 deletions
diff --git a/docs/wiki/Getting-Started.md b/docs/wiki/Getting-Started.md
index 205f2422..de190729 100644
--- a/docs/wiki/Getting-Started.md
+++ b/docs/wiki/Getting-Started.md
@@ -1,3 +1,26 @@
+## Quick start
+
+Use these commands to install niri with [DankMaterialShell](https://github.com/AvengeMedia/DankMaterialShell) for a fairly out-of-the-box experience.
+
+Fedora:
+```
+sudo dnf copr enable avengemedia/dms
+sudo dnf install niri dms
+systemctl --user add-wants niri.service dms
+```
+
+Arch Linux (via [paru](https://github.com/morganamilo/paru)):
+```
+sudo pacman -Syu niri xwayland-satellite xdg-desktop-portal-gnome xdg-desktop-portal-gtk
+paru -S dms-shell-bin
+systemctl --user add-wants niri.service dms
+```
+
+After running these commands, log out, choose Niri in your display manager, and log back in.
+Or, if not using a display manager, run `niri-session` on a TTY.
+
+## Slower and more considered start
+
The easiest way to get niri is to install one of the distribution packages.
Here are some of them: [Fedora COPR](https://copr.fedorainfracloud.org/coprs/yalter/niri/) and [nightly COPR](https://copr.fedorainfracloud.org/coprs/yalter/niri-git/) (which I maintain myself), [NixOS Flake](https://github.com/sodiboo/niri-flake), and some more from repology below, including a [pacstall package](https://pacstall.dev/packages/niri/) for Debian-based distros.
See the [Building](#building) section if you'd like to compile niri yourself and the [Packaging niri](./Packaging-niri.md) page if you want to package niri.