aboutsummaryrefslogtreecommitdiffhomepage
path: root/index.md
diff options
context:
space:
mode:
authorBradley Taunt <bt@btxx.org>2025-01-09 10:21:57 -0500
committerBradley Taunt <bt@btxx.org>2025-01-09 10:21:57 -0500
commit157102e92f51070ecb1c9f71483982c7de6acdc4 (patch)
tree2de94cea06681cdb582ca2830b7c7f1b01173e5a /index.md
parent35de97d950cae3900bf3765c2e40d89e5d52b599 (diff)
Slowly fleshing out content, initial imagery
Diffstat (limited to 'index.md')
-rw-r--r--index.md47
1 files changed, 37 insertions, 10 deletions
diff --git a/index.md b/index.md
index ab34d63..899d954 100644
--- a/index.md
+++ b/index.md
@@ -58,20 +58,15 @@ Before we do anything, we should give our main user full access via `doas`. Logi
su -
echo "permit nopass :wheel" >> /etc/doas.conf
+ exit
-Now you can logout or reboot the machine.
-
- doas reboot
-
-Running any of the commands might present you with a permissions error. If that happens, simply add `doas` to the start of every command.
### Firmware
-Once your machine reboots, login as your created user. The next steps will help you ensure you have the latest firmware.
+The next steps will help you ensure you have the latest firmware.
Simply run the command: `fw_update`
-
### WiFi
To enable wifi on your device, run the following command (filling in the proper details where need be)
@@ -88,7 +83,6 @@ Take note of the `iwn0`, as this might differ on your machine. (You can check th
You might also need to run `doas sh /etc/netstart` after.
-
### Performance Boost
This step is optional and targeted towards devices with batteries (laptops, IoT devices etc). Properly setup apmd:
@@ -103,16 +97,49 @@ Remember when we chose `No` when the installer asked us "X Window System start w
doas rcctl enable xenodm
-Now reboot your device again.
+Now reboot your device.
doas reboot
## The First *Real* Login
+Now you will be presented with the glorious `xenodm` login screen.
+
+<figure>
+<img src="./xenodm-stock.png" alt="Default xenodm login screen">
+<figcaption>The beautiful, default xenodm login screen. Image taken from <a href="https://www.tumfatig.net/2019/customizing-openbsd-xenodm/">tumfatig.net</a> (who has some wonderful OpenBSD guides you should check out!)</figcaption>
+</figure>
+
+Login with your created user details and you should see something like this:
+
+<figure>
+<img src="./fvwm.png" alt="Default fvwm view once logged in">
+<figcaption>Taken from the main OpenBSD Wikipedia page. (Some applications will not be opened by default)</figcaption>
+</figure>
+
+Absolutely glorious. You'll also notice a 3x3 grid box in the bottom right corner:
+
+<img src="./pager.png" alt="fvwm workspace pager">
+
+This is called the "workspace pager" or "pager". Each section represents an individual *desktop* (or workspace if your more familiar with MacOS terminology). You can click on any grid item to instantly move to that desktop.
+
+You can also navigate around using the <kbd>Ctl</kbd> + <kbd>&uarr;</kbd><kbd>&rarr;</kbd><kbd>&darr;</kbd><kbd>&larr;</kbd> keys.
+
+## Additional Packages
+
+- aerc
+- Firefox
+- ffmpeg
+- picom
+
## Configs
Okay, I *know* I said there wouldn't be any configs included in this guide. Frankly, you should be having zero problems working with all those defaults now that you've run through this guide! BUT - I wanted to include some *very minor* configuration tweaks that might make things a little more intuitive for newcomers. Feel free to ignore these entirely!
-## Contribute
+## Support OpenBSD
+
+If you've found this guide helpful or even sparked an interest in OpenBSD, please consider [donating directly to the OpenBSD Project](https://www.openbsd.org/donations.html). A little goes a long way, and the OpenBSD Project is a volunteer-driven software group funded by donations!
+
+## Contribute to OpenBASED
I'm far from an OpenBSD expert! Please [help improve this project](https://git.sr.ht/~bt/openbased)!