Basic installer script for suckless programs on OpenBSD
Clean up README and dependencies files
Update core repo name in README file
Image needs to be relative to core URL


browse  log 



You can also use your local clone with git send-email.

#Open Suck

Lightweight Desktop installer for OpenBSD based on the suckless philosophy. Includes my own custom set of suckless tools (dwm, slstatus, dmenu, etc.)

Screenshot of dwm running onOpenBSD

Successfully installed on:

  • ThinkPad X201
  • ThinkPad X260
  • Lenovo M73 Tiny

#What You Get

The Open Suck installer gives you the absolute barebones desktop experience:

  • dwm for window management
  • Firefox 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


  1. Download the latest OpenBSD iso and follow the installer
  2. Install git, vim, bash
  3. Edit/create doas permissions (/etc/doas.conf):
permit nopass :wheel

Now logout and log back in as your main user.

Clone the main installer project:

git clone https://git.sr.ht/~bt/open-suck

cd open-suck


  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


cd open-suck # CD into this repository
doas sh ./install-dependencies.sh # Install OpenBSD packages

Be sure to edit the main install.sh file and change the username "bt" to your own:

mkdir /home/bt/.suckless
cd /home/bt/.suckless

Save your changes and then run:

doas sh ./install.sh # Install suckless tools
cp .xinitrc ~/.xinitrc # Apply .xinitrc

Reboot the machine. Log in as your main user. Run:


#Optimizing OpenBSD

#Improving Battery Performance

Properly setup apmd:

rcctl enable apmd
rcctl set apmd flags -A
rcctl start apmd

#Setup WiFi

The following assumes you have installed/setup the proper firmware updates for your hardware.

ifconfig iwn0 nwid ID wpakey PASSPHRASE

Take note of the iwn0, as this might differ on your machine.

You might also need to run doas sh /etc/netstart after.