Add section summary pages and make single-link admonitions clickable

This commit is contained in:
Djeex
2026-09-04 18:51:42 +02:00
parent f2cfa49150
commit 9c5a693281
60 changed files with 451 additions and 174 deletions
+68
View File
@@ -0,0 +1,68 @@
---
title: General
description: General homelab knowledge, networking, storage, and hardware fundamentals that apply beyond any single self-hosted app.
navigation:
icon: i-lucide-bookmark
---
:ellipsis{left=0px width=40rem top=10rem blur=140px zIndex=60}
## Homelab Fundamentals
This section covers the general knowledge that [Serveex](/serveex/introduction) itself relies on but doesn't re-explain every time: how networking actually works at home, how to choose and set up storage, and what hardware to run it all on. Read it once, then link back to it from any app-specific guide.
### Networking
:::div{class="relative"}
:ellipsis{left=0px width=40rem top=10rem blur=140px}
:::
::card-group
::card{icon="i-lucide-router" title="NAT & DHCP" to="/general/networking/nat"}
Port forwarding and fixed DHCP leases on your router
::
::card{icon="i-lucide-globe" title="DNS Zone" to="/general/networking/dns"}
Reading and editing a domain's DNS zone
::
::card{icon="i-lucide-folder-sync" title="Samba" to="/general/networking/samba"}
Share folders over the local network
::
::
### Storage
:::div{class="relative"}
:ellipsis{left=0px width=40rem top=10rem blur=140px}
:::
::card-group
::card{icon="i-lucide-database" title="RAID" to="/general/storage/raid"}
Redundant disk arrays, hardware vs software
::
::card{icon="i-lucide-layers" title="ZFS" to="/general/storage/zfs"}
Snapshots, checksums, and built-in redundancy
::
::
### Hardware
:::div{class="relative"}
:ellipsis{left=0px width=40rem top=10rem blur=140px}
:::
::card-group
::card{icon="i-lucide-cpu" title="The Basics" to="/general/hardware/basics"}
CPUs, RAM, storage, and form factors
::
::card{icon="i-lucide-network" title="Network" to="/general/hardware/network"}
Switches, NICs, and cabling
::
::card{icon="i-lucide-hard-drive" title="The ProloNAS" to="/general/hardware/prolonas"}
A budget N100 home server build
::
::
@@ -43,10 +43,10 @@ This is useful when you have a server that must be accessible from the internet.
To make the website accessible, you'll configure your router to redirect the domain request to your local server.
Assume your service runs on port `3000` locally (`http://192.168.1.50:3000`), you would redirect all traffic from port `443` on the router to port `3000` on the local server.
::warning
::warning{to="/serveex/core/swag"}
__Warning:__ If you have multiple services to expose like `subdomain1.mydomain.com` and `subdomain2.mydomain.com`, your router cannot differentiate requests and forward to different ports.
You must use a [Reverse Proxy](../../serveex/core/swag) to route traffic based on the request.
You must use a **Reverse Proxy** to route traffic based on the request.
::
## DHCP
@@ -40,8 +40,8 @@ Now, edit the file `/etc/samba/smb.conf`.
sudo nano /etc/samba/smb.conf
```
::tip{icon=""}
__Tip:__ You can use [File Browser Quantum](/serveex/files/file-browser-quantum) to navigate and edit your files instead of using terminal commands.
::tip{icon="" to="/serveex/files/file-browser-quantum"}
__Tip:__ You can use **File Browser Quantum** to navigate and edit your files instead of using terminal commands.
::
Find the `workgroup` variable and name your workgroup (e.g., `workgroup = WORKGROUP`).
@@ -54,9 +54,9 @@ ZFS includes its own volume management system (vdevs). You can build a zpool usi
ZFS handles all this natively: no external RAID software needed.
::note
::note{to="/general/storage/raid"}
Check out the [article on RAID](/general/storage/raid) to find the right solution for your needs.
Check out the **article on RAID** to find the right solution for your needs.
::
### Snapshots and Clones
@@ -76,8 +76,8 @@ Today, HDDs can store enormous amounts of data (up to 30TB, or 30,000 gigabytes,
Generally, HDDs are best suited for storing data that doesnt require frequent access or fast write speeds, such as media files (videos, photos), cloud drives, or archived data. They perform well in these scenarios and, most importantly, are significantly cheaper than SSDs for the same amount of storage.
::tip{icon=""}
__Tip:__ Use multiple HDDs in [RAID](/general/storage/raid) to enhance performance and redundancy.
::tip{icon="" to="/general/storage/raid"}
__Tip:__ Use multiple HDDs in **RAID** to enhance performance and redundancy.
::
Comes in 3.5" and 2.5" formats; servers usually favor the more reliable 3.5".