diff options
Diffstat (limited to 'index.md~')
-rw-r--r-- | index.md~ | 118 |
1 files changed, 118 insertions, 0 deletions
diff --git a/index.md~ b/index.md~ new file mode 100644 index 0000000..37ba1d7 --- /dev/null +++ b/index.md~ @@ -0,0 +1,118 @@ +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)! |