1 files changed, 60 insertions, 0 deletions
diff --git a/wiki/openbsd_desktop_environment.md b/wiki/openbsd_desktop_environment.md
new file mode 100644
index 0000000..993da29
--- /dev/null
+++ b/wiki/openbsd_desktop_environment.md
@@ -0,0 +1,60 @@
+---
+layout: page
+title: OpenBSD Desktop Environment
+permalink: /wiki/openbsd/desktop_environment
+---
+
+This page covers the initial setup for installing and configuring `dwm` as a desktop environment on OpenBSD. Everything posted here relies on my personal "Open Suck" installer: [Open Suck](https://git.btxx.org/open-suck/about/)
+
+## Show Don't Tell
+
+<figure>
+<img src="https://btxx.org/posts/OpenBSD_is_a_Cozy_Operating_System/open-suck-75.png" alt="Screenshot of OpenBSD 7.5 running dwm">
+<figcaption>Open Suck: OpenBSD 7.5 running dwm on my X220</figcaption>
+</figure>
+ 
+## What You Get
+
+The Open Suck installer gives you the absolute barebones desktop experience:
+
+- `dwm` for window management
+- `qutebrowser` as your core web browser
+- `aerc` for your terminal-based mail client
+- `slock` for screen locking
+- `scrot`/`slop` for simple screenshot utilities
+- `dunst` for notifications
+
+## Required Packages
+
+Before we begin setting things up, you will need to install `git`, `vim`, `bash`:
+
+    pkg_add git vim bash
+
+## Cloning the Project
+
+Clone the main installer project and navigate instead the directory:
+
+    git clone https://git.btxx.org/open-suck
+    cd open-suck
+
+## Installing
+
+1. Install dependencies by running `./install-dependencies.sh`. The script will simply read required packages from `dependencies.txt` and run `pkg_add`.
+2. Compile and install suckless software by running the `./install.sh`
+
+## TL;DR
+
+    # Install OpenBSD packages
+    doas sh ./install-dependencies.sh
+    # Install suckless tools
+    doas sh ./install.sh
+    # Apply .xinitrc
+    cp .xinitrc ~/.xinitrc
+
+Reboot the machine. Log in as your main user. Run:
+
+
+    startx
+
+
+That's it! You now have a fully functional desktop environment built on top of `dwm`.