Skip to content

Instantly share code, notes, and snippets.

@asad-albadi

asad-albadi/Homelab Overview.md

Last active June 27, 2025 12:32
Show Gist options
  • Save asad-albadi/35387bd422d295fd79416d42febe7f7d to your computer and use it in GitHub Desktop.
Save asad-albadi/35387bd422d295fd79416d42febe7f7d to your computer and use it in GitHub Desktop.
Download ZIP
Raw
Homelab Overview.md

Hardware Overview

Device Processor RAM Storage Graphics Additional Specs
Raspberry Pi 4 Model B Broadcom BCM2711, Quad-core Cortex-A72 @ 1.5GHz 4GB LPDDR4-3200 MicroSD card slot Broadcom VideoCore VI Dual-band Wi-Fi, Bluetooth 5.0, Gigabit Ethernet, 4 USB ports, 2 micro-HDMI ports
Raspberry Pi 5 Broadcom BCM2712, Quad-core Cortex-A76 @ 2.4GHz 8GB LPDDR4X-4267 MicroSD card slot (high-speed SDR104) VideoCore VII Dual-band Wi-Fi, Bluetooth 5.0 / BLE, Gigabit Ethernet, USB-C, Dual 4K HDMI
Lenovo ThinkCentre M910q Intel Core i5-6500T (4 cores, up to 3.1 GHz) 8GB DDR4 500GB SSD Integrated Intel HD Graphics 530 Ethernet, optional Wi-Fi/Bluetooth, 6 USB 3.1, 2 DisplayPort, VGA
Dell Precision Workstation T5400 2x Intel Xeon E5410 @ 2.33GHz 16GB DDR2 ECC 240GB SSD, 2x 500GB HDD NVIDIA GeForce GTX 660 Ti -
RiftRaven Micro Firewall Appliance Intel Celeron J4125 @ 1.996GHz Quad Core 8GB 128GB mSATA SSD UHD Graphics 600 4x 2.5 Gbps LAN ports
Custom Gaming PC (SY-WIND) Intel Core i7 8700k @ 3.70Ghz 16GB DDR4 480GB SSD, 1TB M.2, 2TB + 4TB HDD ASUS ROG Strix GTX 1080TI -
ASUS TUF Dash F15 FX516PC 11th Gen Intel i5-11300H @ 4.400GHz 8GB DDR4 500GB NVMe NVIDIA GeForce RTX 3050, Intel Iris Xe Graphics -

20240224_135507-COLLAGE-COLLAGE

Networking and Storage Equipment

Type Device Specs
NAS Dell Precision Workstation T5400 Used for data storage and management
Switch TP-Link LS1008G, TP-Link TL-SG105 Gigabit desktop switches for enhanced connectivity
Router Xiaomi AX3000 Wi-Fi 6 router for improved network management

Peripheral Devices

Device Description Key Features
3D Printer Ender 3 V2 Neo FDM technology, 220 x 220 x 250mm build volume, PLA/ABS/PETG
Microcontrollers Arduino UNO R4 WiFi, Arduino UNO R3, NodeMCU V3 (ESP8266) Used for various projects and prototyping

Technologies and Containers Checklist

Containerization & Orchestration

  • Docker
  • Docker Swarm
  • Docker Compose
  • Kubernetes

Network Security

  • OPNsense
  • Firewalls Configuration

Databases

  • PostgreSQL
  • MongoDB

Monitoring Services

  • Wazuh
  • PiAlert
  • Scrutiny
  • Glances

Home Automation

  • Home Assistant

Virtualization

  • Proxmox

Containers Used with Descriptions

Status Project Description
ilteoood/docker-surfshark Docker container with OpenVPN client preconfigured for SurfShark
✓ OctoPrint OctoPrint is an open source 3D printer controller application, which provides a web interface for the connected printers.
✓ bookstack A platform for creating, organizing, and storing documentation or notes.
Unifi Network Application software is a powerful, enterprise wireless software engine ideal for high-density client deployments requiring low latency and high uptime performance.
✓ cloudbeaver An open-source database management tool that supports various databases.
✓ dozzle A web-based, interactive log viewer for Docker containers.
✓ glances container A cross-platform system monitoring tool that provides detailed information about your system's performance.
✓ ctop provides a concise and condensed overview of real-time metrics for multiple containers
✓ grafana A widely-used platform for monitoring and analyzing metrics with customizable dashboards.
✓ Srutiny is a Hard Drive Health Dashboard & Monitoring solution, merging manufacturer provided S.M.A.R.T metrics with real-world failure rates.
✓ Dashy is an open source, highly customizable, easy to use, privacy-respecting dashboard app
Homer A dead simple static HOMepage for your servER to keep your services on hand, from a simple yaml configuration file.
✓ homepage A customizable, personal homepage to centralize links, notes, and more.
✓ Portainer API
✓ huginn A system for building agents that perform automated tasks and workflows online.
✓ joplin-server A server component for Joplin, an open-source note-taking app.
✓ mongodb A Docker image for running MongoDB, a NoSQL database system.
✓ netdata A monitoring solution that provides real-time insights into system performance and health.
✓ nginx Proxy Manager A web-based GUI for managing Nginx reverse proxy configurations.
✓ nosqlclient A cross-platform NoSQL database client.
✓ plex A media server platform for managing and streaming your multimedia content.
✓ pihole A network-level ad blocker and DNS sinkhole.
✓ postgres A Docker image for running PostgreSQL, a powerful open-source relational database system.
✓ uptime-kuma A self-hosted monitoring solution to track the uptime and response times of various services.
✓ vaultwarden An open-source password manager compatible with Bitwarden clients.
✓ Ngnix is a web server that can also be used as a reverse proxy, load balancer, mail proxy and HTTP cache.
✓ Gotify A simple server for sending and receiving message.
✓ Gotify Indicator Gotify Indicator is an application to recieve and send messages from your own Gotify Server.
✓ wazuh A security information and event management (SIEM) platform for monitoring and analyzing security events.
✓ What's up Docker? Gets you notified when new versions of your Docker containers are available and lets you react the way you want.
✓ Portainer is an open-source service that provides a visual web view for containerized applications. it is a container management tool for Docker, Docker swarm, Kubernetes, and Azure Container Instances (ACI).
✓ Pi-Alert is a WIFI / LAN intruder detector.
✓ qBittorrent qBittorrent is a cross-platform free and open-source BitTorrent client.
✓ VueTorrent The sleekest looking WebUI for qBittorrent made with Vue.js!

Modules and Sensors

Image ID Name Category
image Photoresistor LDR Module Light and Sensing Modules
image SEN-02527 Infrared Obstacle Avoidance Sensor Light and Sensing Modules
image PIR (motion) sensor Motion and Vibration Modules
image IR Infrared Flame Sensor Module Light and Sensing Modules
image KY-037 High Sensitivity Sound Detection Module Light and Sensing Modules
image ESP-01S ESP8266 WiFi Module Communication and Connectivity Modules
image KY-016 RGB Full color LED module Light and Sensing Modules
image
image		 DHT11 Temperature-Humidity Sensor Module Light and Sensing Modules
image Microphone Sound Sensor Module Voice Sensor
High Sensitivity Sound Detection Module
Whistle Module		 Light and Sensing Modules
image TCRT5000 Line tracking sensor User Interaction Modules
image MQ-2 Gas Sensor Gas and Fluid Sensing Modules
image NYLSA SW-420 Vibration Tilt Sensor Alarm Module
Motion Shake Shock		 Motion and Vibration Modules
image KY-019 5V Relay Module Actuators and Motors
image
image		 ULN2003
28BYJ-48		 DC 5V 28BYJ-48 Stepper Motor
with ULN2003 Driver Board		 Actuators and Motors
image FC-28 Soil moisture detection sensor Light and Sensing Modules
image DS1302 Real Time Clock Module Communication and Connectivity Modules
image Micro SD Card Module Communication and Connectivity Modules
image
image		 Serial LCD Module Display 16x2
LCD I2C PCF8574 Interface Adapter		 Communication and Connectivity Modules
image
image		 RF Tx-Rx Module
Receiver & Transmitter		 Communication and Connectivity Modules
image SW-520D Angle Sensor Module
Golden Ball Switch Tilt Sensor Module		 User Interaction Modules
image KY-008 Laser Transmitter Module Actuators and Motors
image high sensitivity water sensor Gas and Fluid Sensing Modules
image HC-SR04 Ultrasonic Distance Sensor Light and Sensing Modules
image 4x4 Matrix Button Keypad Module 16 Keys 8 Pin User Interaction Modules
image KY-023 Joystick module User Interaction Modules
image Tactile Tact Push Button Micro Switch
11x11x4.3MM 4PIN		 User Interaction Modules
image
image		 10 Pin 1 Bit Seven Segment Display
LED Display Digital Tube		 User Interaction Modules
image 8x8 Dot matrix LED User Interaction Modules
image SG90 Micro Servo Motor Actuators and Motors
image Rain Water Sensor Module
12V Rain Water Raindrops Detection Sensor Module
Relay Control Module with Potentiometer		 User Interaction Modules
image RC522 RFID module Other Modules
image Infrared IR remote controller Communication and Connectivity Modules
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment