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 /index.md~ | |
parent | 35de97d950cae3900bf3765c2e40d89e5d52b599 (diff) |
Slowly fleshing out content, initial imagery
Diffstat (limited to 'index.md~')
-rw-r--r-- | index.md~ | 118 |
1 files changed, 0 insertions, 118 deletions
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)! |