OpenBSD Knowledge Base 🐡

      _____                 ____   _____ _____   
     / ___ \               |  _ \ / ____|  __ \  
    / /  / /___  ___  ____ | |_) | (___ | |  | | 
   / /  / / __ \/ _ \/ __ \|  _ < \___ \| |  | | 
  / /__/ / /_/ /  __/ / / /| |_) |____) | |__| | 
  \_____/ .___/\___/_/ /_/ |____/|_____/|_____/  
       /_/                                       
              |    .            The proactively secure Unix-like
          .   |L  /|   .        Operating System.
      _ . |\ _| \--+._/| .      Please visit the OpenBSD web site
     / ||\| Y J  )   / |/| ./	  at http://www.openbsd.org/
    J  |)'( |        ` F`.'/
  -<|  F         __     .-<     All transfers are logged, if you don't
    | /       .-'. `.  /-. L___ like this policy, disconnect now!
    J \      <    \  | | O\|.-' 
  _J \  .-    \/ O | | \  |F    
 '-F  -<_.     \   .-'  `-' L__ OpenBSD 6.4 has now been released!      
__J  _   _.     >-'  )._.   |-' You can order a CD of OpenBSD 6.5       
`-|.'   /_.           \_|   F   from http://www.openbsd.org/orders.html.
  /.-   .                _.<    CD sales are important to support the   
 /'    /.'             .'  `\	continued development of the project.   
  /L  /'   |/      _.-'-\      
 /'J       ___.---'\|	       
   |\  .--' V  | `. `          @victxrlarixs
   |/`. `-.     `._)           
      / .-.\		       
      \ (  `\                  
       `.\

A personal collection of articles, guides, configuration files, and visual resources about OpenBSD.
This repository acts as a practical handbook for system administration, security, networking, and desktop customization on OpenBSD.

Designed as a quick reference for real-world installations, basic hardening, and common OpenBSD setups.

---

📚 Contents

The project is organized by categories:

📄 Articles

Technical write-ups and practical notes:

• collectD-graphs.md – Monitoring and graphs with collectd
• relayD-block-bots.md – Blocking bots with relayd
• relayD-security-headers.md – Security headers with relayd

🎨 ASCII-Art

Terminal ASCII art for banners and welcome screens:

• BlowFish.md
• Neofetch.md
• OBSD.md
• Welcome.md

⚙️ Config-Files

Real-world or example configuration files:

• .kshrc – Shell configuration
• conky.conf – Conky desktop widget
• doas.conf – Privilege configuration
• hostname.athn0 – WiFi network config
• httpd.conf – Web server configuration
• pf.conf – Firewall (Packet Filter) rules

📘 Guides

Step-by-step practical guides:

• After-Install.md – Post-installation setup
• Apu-Router.md – OpenBSD router on APU hardware
• edge-router.md – Edge router configuration
• VMM.md – Virtualization with VMM

📓 Handbook

Quick notes and references:

• Puffy.md – OpenBSD mascot notes and references

🖼️ UnixPorn

Desktop screenshots and visual setups:

• OpenBSD-KDE.png
• OpenBSD-KDE2.png
• OpenBSD-KDE3.png
• OpenBSD-XFCE.png
• XFCE-Conky.png

---

🎯 Project Goals

• Maintain a personal OpenBSD knowledge base
• Document real-world configurations used in labs or production
• Serve as a cheat sheet for future installations
• Provide inspiration for minimal and clean OpenBSD desktop setups

---

🚀 Recommended Usage

Clone the repository and browse the documents depending on your needs:

git clone https://github.com/your-username/openbsd-knowledge-base.git
cd openbsd-knowledge-base

🧠 Notes

• Configuration files may require adjustments depending on your hardware.
• Some guides assume basic OpenBSD knowledge.
• This repository is opinionated and reflects my personal workflow with OpenBSD.

🤝 Contributions

This repository is mainly personal, but contributions are welcome:

• Pull requests for improvements
• Issues for suggestions or corrections