From 157102e92f51070ecb1c9f71483982c7de6acdc4 Mon Sep 17 00:00:00 2001 From: Bradley Taunt Date: Thu, 9 Jan 2025 10:21:57 -0500 Subject: Slowly fleshing out content, initial imagery --- index.md | 47 +++++++++++++++---- index.md~ | 118 ------------------------------------------------ public/fvwm.png | Bin 0 -> 72454 bytes public/index.html | 53 +++++++++++++++++----- public/pager.png | Bin 0 -> 1021 bytes public/style.css | 11 ++++- public/xenodm-stock.png | Bin 0 -> 60439 bytes 7 files changed, 89 insertions(+), 140 deletions(-) delete mode 100644 index.md~ create mode 100644 public/fvwm.png create mode 100644 public/pager.png create mode 100644 public/xenodm-stock.png 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. + +
+Default xenodm login screen +
The beautiful, default xenodm login screen. Image taken from tumfatig.net (who has some wonderful OpenBSD guides you should check out!)
+
+ +Login with your created user details and you should see something like this: + +
+Default fvwm view once logged in +
Taken from the main OpenBSD Wikipedia page. (Some applications will not be opened by default)
+
+ +Absolutely glorious. You'll also notice a 3x3 grid box in the bottom right corner: + +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 Ctl + ↑→↓← 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 new file mode 100644 index 0000000..4b3b9fe Binary files /dev/null and b/public/fvwm.png differ 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 @@
  • Login Manager
  • The First Real Login
    • +
  • Additional Packages
  • Configs
    • -
  • Contribute
    • +
  • Support OpenBSD
    • +
  • Contribute to OpenBASED
    • @@ -93,18 +95,12 @@ 
    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

    @@ -141,18 +137,53 @@ rcctl start apmd 
    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.

    + +
    +Default xenodm login screen +
    The beautiful, default xenodm login screen. Image taken from tumfatig.net (who has some wonderful OpenBSD guides you should check out!)
    +
    + +

    Login with your created user details and you should see something like this:

    + +
    +Default fvwm view once logged in +
    Taken from the main OpenBSD Wikipedia page. (Some applications will not be opened by default)
    +
    + +

    Absolutely glorious. You’ll also notice a 3x3 grid box in the bottom right corner:

    + +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 Ctl + ↑→↓← keys.

    + +

    Additional Packages

    + + +

    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. 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!

    diff --git a/public/pager.png b/public/pager.png new file mode 100644 index 0000000..13d0d61 Binary files /dev/null and b/public/pager.png differ 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 new file mode 100644 index 0000000..a6e4750 Binary files /dev/null and b/public/xenodm-stock.png differ -- cgit v1.2.3-70-g09d2