aboutsummaryrefslogtreecommitdiffhomepage
path: root/index.md~
diff options
context:
space:
mode:
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)!