diff options
author | Bradley Taunt <bt@btxx.org> | 2025-01-09 10:21:57 -0500 |
---|---|---|
committer | Bradley Taunt <bt@btxx.org> | 2025-01-09 10:21:57 -0500 |
commit | 157102e92f51070ecb1c9f71483982c7de6acdc4 (patch) | |
tree | 2de94cea06681cdb582ca2830b7c7f1b01173e5a | |
parent | 35de97d950cae3900bf3765c2e40d89e5d52b599 (diff) |
Slowly fleshing out content, initial imagery
-rw-r--r-- | index.md | 47 | ||||
-rw-r--r-- | index.md~ | 118 | ||||
-rw-r--r-- | public/fvwm.png | bin | 0 -> 72454 bytes | |||
-rw-r--r-- | public/index.html | 53 | ||||
-rw-r--r-- | public/pager.png | bin | 0 -> 1021 bytes | |||
-rw-r--r-- | public/style.css | 11 | ||||
-rw-r--r-- | public/xenodm-stock.png | bin | 0 -> 60439 bytes |
7 files changed, 89 insertions, 140 deletions
@@ -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>↑</kbd><kbd>→</kbd><kbd>↓</kbd><kbd>←</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)! diff --git a/index.md~ b/index.md~ deleted file mode 100644 index 37ba1d7..0000000 --- a/index.md~ +++ /dev/null @@ -1,118 +0,0 @@ -Setup OpenBSD as a daily driver using only the included, base programs. Based on OpenBSD 7.6. - ---- - -{{TOC}} - -## Requirements - -- USB device -- Ethernet connection (with active internet) -- A cup of coffee - -The real requirements are having patience and a passion for keeping things minimal. It's important to remeber that this setup isn't the most user-friendly. There will be no config files to edit or download in this guide. We will be using the `xenodm` login manager paired with the default stacked window manager `fvwm`. And that's it. - -You have been warned! - -## Installation - -Make sure you have the latest OpenBSD image formatted on a USB device (or burned to a CD if that's your cup of tea!) and that your computer/laptop is set to boot from USB via the BIOS. Also make sure you are connected to the internet via ethernet cable (don't worry, we'll setup WiFi in a minute!) - -Boot into the device and input the following when guided through the installer: - -1. Boot from USB -2. Choose `Install` -3. Keyboard layout: `us` -4. Hostname: `x220` (or whatever you choose) -5. Network: `em0` -6. IPv4: `autoconf` -7. IPv6: `none` -8. Network interface: `done` -9. Password for root -10. Start sshd by default? `yes` -11. X Window System start with xenodm? `no` -12. Setup user? `username` (follow setup user steps) -13. Allow root ssh login? `no` -14. Timezone -15. Which disk? Use internal (`sd0` etc.) -16. Encrypt root disk? `no` -17. Use `WHOLE` disk -18. Use `AUTO` layout -19. Which disk to initialize: `done` -20. Location of sets: `http` -21. HTTP Proxy URL? `none` -22. HTTP Server? `1` (Toronto) -23. Confirm again -24. Server directory? `pub/OpenBSD/7.6/amd64` -25. Set names? `done` -26. Drink some coffee while it verifies (depends on network speed) -27. Location of sets? `done` -28. Congrats! -29. Reboot and remove USB device - -## First Boot Tweaks - -### User Permissions - -Before we do anything, we should give our main user full access via `doas`. Login as `root` and run the following: - - su - - echo "permit nopass :wheel" >> /etc/doas.conf - -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. - -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) - - ifconfig iwn0 up - ifconfig iwn0 scan - echo "join WIFI-NAME wpakey PASSPHRASE" >> /etc/hostname.iwn0 - echo "dhcp" >> /etc/hostname.iwn0 - echo "inet6 autoconf" >> /etc/hostname.iwn0 - echo "up powersave" >> /etc/hostname.iwn0 - dhclient iwn0 - -Take note of the `iwn0`, as this might differ on your machine. (You can check this by running `ifconfig`) - -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: - - rcctl enable apmd - rcctl set apmd flags -A - rcctl start apmd - -## Login Manager - -Remember when we chose `No` when the installer asked us "X Window System start with xenodm?". Well, now we want to enable that before our next reboot: - - doas rcctl enable xenodm - -Now reboot your device again. - - doas reboot - -## The First *Real* Login - -## 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 - -I'm far from an OpenBSD expert! Please [help improve this project](https://git.sr.ht/~bt/openbased)! diff --git a/public/fvwm.png b/public/fvwm.png Binary files differnew file mode 100644 index 0000000..4b3b9fe --- /dev/null +++ b/public/fvwm.png diff --git a/public/index.html b/public/index.html index 89335cd..1a89d97 100644 --- a/public/index.html +++ b/public/index.html @@ -30,8 +30,10 @@ </li> <li><a href="#loginmanager">Login Manager</a></li> <li><a href="#thefirstreallogin">The First <em>Real</em> Login</a></li> +<li><a href="#additionalpackages">Additional Packages</a></li> <li><a href="#configs">Configs</a></li> -<li><a href="#contribute">Contribute</a></li> +<li><a href="#supportopenbsd">Support OpenBSD</a></li> +<li><a href="#contributetoopenbased">Contribute to OpenBASED</a></li> </ul> </div> @@ -93,18 +95,12 @@ <pre><code>su - echo "permit nopass :wheel" >> /etc/doas.conf +exit </code></pre> -<p>Now you can logout or reboot the machine.</p> - -<pre><code>doas reboot -</code></pre> - -<p>Running any of the commands might present you with a permissions error. If that happens, simply add <code>doas</code> to the start of every command.</p> - <h3 id="firmware">Firmware</h3> -<p>Once your machine reboots, login as your created user. The next steps will help you ensure you have the latest firmware.</p> +<p>The next steps will help you ensure you have the latest firmware.</p> <p>Simply run the command: <code>fw_update</code></p> @@ -141,18 +137,53 @@ rcctl start apmd <pre><code>doas rcctl enable xenodm </code></pre> -<p>Now reboot your device again.</p> +<p>Now reboot your device.</p> <pre><code>doas reboot </code></pre> <h2 id="thefirstreallogin">The First <em>Real</em> Login</h2> +<p>Now you will be presented with the glorious <code>xenodm</code> login screen.</p> + +<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> + +<p>Login with your created user details and you should see something like this:</p> + +<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> + +<p>Absolutely glorious. You’ll also notice a 3x3 grid box in the bottom right corner:</p> + +<img src="./pager.png" alt="fvwm workspace pager"> + +<p>This is called the “workspace pager” or “pager”. Each section represents an individual <em>desktop</em> (or workspace if your more familiar with MacOS terminology). You can click on any grid item to instantly move to that desktop.</p> + +<p>You can also navigate around using the <kbd>Ctl</kbd> + <kbd>↑</kbd><kbd>→</kbd><kbd>↓</kbd><kbd>←</kbd> keys.</p> + +<h2 id="additionalpackages">Additional Packages</h2> + +<ul> +<li>aerc</li> +<li>Firefox</li> +<li>ffmpeg</li> +<li>picom</li> +</ul> + <h2 id="configs">Configs</h2> <p>Okay, I <em>know</em> 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 <em>very minor</em> configuration tweaks that might make things a little more intuitive for newcomers. Feel free to ignore these entirely!</p> -<h2 id="contribute">Contribute</h2> +<h2 id="supportopenbsd">Support OpenBSD</h2> + +<p>If you’ve found this guide helpful or even sparked an interest in OpenBSD, please consider <a href="https://www.openbsd.org/donations.html">donating directly to the OpenBSD Project</a>. A little goes a long way, and the OpenBSD Project is a volunteer-driven software group funded by donations!</p> + +<h2 id="contributetoopenbased">Contribute to OpenBASED</h2> <p>I’m far from an OpenBSD expert! Please <a href="https://git.sr.ht/~bt/openbased">help improve this project</a>!</p> <hr> diff --git a/public/pager.png b/public/pager.png Binary files differnew file mode 100644 index 0000000..13d0d61 --- /dev/null +++ b/public/pager.png diff --git a/public/style.css b/public/style.css index 2814250..22fe4aa 100644 --- a/public/style.css +++ b/public/style.css @@ -33,7 +33,7 @@ header { img { margin: 0 auto; - max-width: 120px; + max-width: 100%; } h1 { @@ -64,6 +64,15 @@ code { background: whitesmoke; } +kbd { + border: 1px solid black; + border-radius: 4px; + box-shadow: 0 2px 4px rgba(0,0,0,0.7); + background: #eee; + color: black; + padding: 4px; +} + p code, li code, dl code { border: 1px solid; padding: 1px 2px; diff --git a/public/xenodm-stock.png b/public/xenodm-stock.png Binary files differnew file mode 100644 index 0000000..a6e4750 --- /dev/null +++ b/public/xenodm-stock.png |