138 lines
13 KiB
Markdown
138 lines
13 KiB
Markdown
---
|
|
tags:
|
|
- Documentation
|
|
- Bookstack
|
|
- Notes
|
|
---
|
|
# Home-Lab Environment
|
|
|
|
# Environment Documentation
|
|
|
|
I have standardized your domain listings into a clean table, removed the empty unassigned IP rows to reduce clutter (while keeping your standard sequential block visible), and extracted the miscellaneous Windows 10 license key into a dedicated, secure metadata section so it doesn't skew your networking tables.
|
|
|
|
# Home-Lab Environment Documentation
|
|
|
|
## 1. Public Domains & External Servers
|
|
|
|
This table tracks external public-facing domains, their current A-record IP destinations, and hosting providers.
|
|
|
|
<table id="bkmrk-domain-name-target-i"><thead><tr><td>**Domain Name**</td><td>**Target IP Address**</td><td>**Host / Provider**</td><td>**Status / Notes**</td></tr></thead><tbody><tr><td><span>`mcfetridge.us`</span></td><td><span>129.213.86.62</span></td><td><span>Oracle Server</span></td><td><span>Active</span></td></tr><tr><td><span>`mikemcfetridge.com`</span></td><td><span>75.152.47.1</span></td><td><span>Home</span></td><td><span>Active</span></td></tr><tr><td><span>`mmcfetridge.net`</span></td><td><span>216.144.227.142</span></td><td><span>RackNerd Server</span></td><td><span>Active</span></td></tr><tr><td><span>`mmcfetridge.xyz`</span></td><td><span>107.175.245.171</span></td><td><span>*N/A*</span></td><td><span>Deprecated / Not used anymore</span></td></tr></tbody></table>
|
|
|
|
## 2. Local IP Asset Management (Subnet: `192.168.2.0/24`)
|
|
|
|
This mapping tracks internal static IPs, infrastructure hosts, container stacks, and active client hardware.
|
|
|
|
### Infrastructure & Server Hosts
|
|
|
|
<table id="bkmrk-ip-address-server-na"><thead><tr><td>**IP Address**</td><td>**Server Name**</td><td>**Applications**</td><td>**Functional Comments**</td></tr></thead><tbody><tr><td><span>**192.168.2.1**</span></td><td><span>PVE</span></td><td><span>Proxmox</span></td><td><span>Main Proxmox Virtualization Environment</span></td></tr><tr><td><span>**192.168.2.2**</span></td><td><span>PVE2</span></td><td><span>Proxmox</span></td><td><span>Secondary Proxmox Node (Cluster/Failover)</span></td></tr><tr><td><span>**192.168.2.3**</span></td><td><span>docker-prod-01</span></td><td><span>Docker</span></td><td><span>Production Docker environment</span></td></tr><tr><td><span>**192.168.2.4**</span></td><td><span>pangolin</span></td><td><span>*None Listed*</span></td><td><span>Assigned host</span></td></tr><tr><td><span>**192.168.2.5**</span></td><td><span>Domain Locker</span></td><td><span>Docker Monitoring</span></td><td><span>Container ecosystem tracking & monitoring</span></td></tr></tbody></table>
|
|
|
|
### Network Services & Core Stacks
|
|
|
|
<table id="bkmrk-ip-address-server-na-1"><thead><tr><td>**IP Address**</td><td>**Server Name**</td><td>**Applications**</td><td>**Functional Comments**</td></tr></thead><tbody><tr><td><span>**192.168.2.8**</span></td><td><span>Pi-Hole</span></td><td><span>Ad-blocking / DNS</span></td><td><span>Network-wide ad blocker</span></td></tr><tr><td><span>**192.168.2.9**</span></td><td><span>TECHNITIUMDNS-SERVER</span></td><td><span>DNS</span></td><td><span>Local authoritative DNS Server</span></td></tr><tr><td><span>**192.168.2.10**</span></td><td><span>ArrStack</span></td><td><span>Media Management</span></td><td><span>Automation stack</span></td></tr><tr><td><span>**192.168.2.12**</span></td><td><span>linkwarden</span></td><td><span>lw</span></td><td><span>Web bookmark and internet link management</span></td></tr><tr><td><span>**192.168.2.15**</span></td><td><span>docker-deploy</span></td><td><span>CI/CD Deployer</span></td><td><span>Dedicated environment for deployments</span></td></tr><tr><td><span>**192.168.2.19**</span></td><td><span>VAULTWARDEN-SERVER</span></td><td><span>Passwords</span></td><td><span>Self-hosted Bitwarden backend (Password Server)</span></td></tr></tbody></table>
|
|
|
|
### End-User Devices & Client Leases
|
|
|
|
<table id="bkmrk-ip-address-device-na"><thead><tr><td>**IP Address**</td><td>**Device Name**</td><td>**Device Type**</td><td>**Functional Comments**</td></tr></thead><tbody><tr><td><span>**192.168.2.248**</span></td><td><span>My iPad</span></td><td><span>Tablet</span></td><td><span>Personal client</span></td></tr><tr><td><span>**192.168.2.249**</span></td><td><span>My Laptop</span></td><td><span>Laptop</span></td><td><span>Primary workstation</span></td></tr></tbody></table>
|
|
|
|
> 💡 **Note:** IP addresses `192.168.2.6` through `192.168.2.7`, `192.168.2.11`, `192.168.2.13` through `192.168.2.14`, `192.168.2.16` through `192.168.2.18`, and `192.168.2.20` through `192.168.2.30` are currently unassigned and reserved for future static scaling.
|
|
|
|
## 3. Network Security & Trusted Subnets (CIDR)
|
|
|
|
The following blocks are designated as **Trusted IP CIDRs** within internal firewall and reverse proxy definitions.
|
|
|
|
- `127.0.0.0/8` — Localhost loopback network
|
|
- `10.0.0.0/8` — Class A Private network space
|
|
- `172.16.0.0/12` — Class B Private network space (Commonly used by internal Docker bridges)
|
|
- `192.168.0.0/22` — Covers local scopes from `192.168.0.0` through `192.168.3.255`
|
|
|
|
## 4. Environment Metadata & Licenses
|
|
|
|
> 🔑 **Windows 10 Pro Generic KMS / Setup Key:** > `W269N-WFGWX-YVC9B-4J6C9-T83GX`
|
|
|
|
# 🌐 Configuring Dynamic DNS (DDNS) with ddclient and Namecheap
|
|
|
|
This guide walks you through installing and configuring `ddclient` on Ubuntu to automatically update your Namecheap domain with your network's public IP address.
|
|
|
|
## 1. Installation
|
|
|
|
Install the `ddclient` utility from the standard package manager:
|
|
|
|
<div class="code-block ng-tns-c1605810258-312 ng-animate-disabled ng-trigger ng-trigger-codeBlockRevealAnimation" id="bkmrk-bash"><div class="formatted-code-block-internal-container ng-tns-c1605810258-312"><div class="animated-opacity ng-tns-c1605810258-312"><div class="code-block-decoration header-formatted gds-emphasized-body-m ng-tns-c1605810258-312 ng-star-inserted"><span class="ng-tns-c1605810258-312">Bash</span><div class="buttons ng-tns-c1605810258-312 ng-star-inserted"></div></div></div></div></div>```
|
|
sudo apt update && sudo apt install ddclient -y
|
|
|
|
```
|
|
|
|
<div class="code-block ng-tns-c1605810258-312 ng-animate-disabled ng-trigger ng-trigger-codeBlockRevealAnimation" id="bkmrk--1"><div class="formatted-code-block-internal-container ng-tns-c1605810258-312"><div class="animated-opacity ng-tns-c1605810258-312"></div></div></div>> 💡 **Note:** During the installation, a text-based setup wizard will appear in your terminal. You can safely select **"Other"** when prompted for a provider and cycle through the defaults. We will completely overwrite these wizard settings manually in the next step.
|
|
|
|
## 2. Configuration
|
|
|
|
Open the configuration file using the `nano` text editor:
|
|
|
|
<div class="code-block ng-tns-c1605810258-313 ng-animate-disabled ng-trigger ng-trigger-codeBlockRevealAnimation" id="bkmrk-bash-1"><div class="formatted-code-block-internal-container ng-tns-c1605810258-313"><div class="animated-opacity ng-tns-c1605810258-313"><div class="code-block-decoration header-formatted gds-emphasized-body-m ng-tns-c1605810258-313 ng-star-inserted"><span class="ng-tns-c1605810258-313">Bash</span><div class="buttons ng-tns-c1605810258-313 ng-star-inserted"></div></div></div></div></div>```
|
|
sudo nano /etc/ddclient.conf
|
|
|
|
```
|
|
|
|
<div class="code-block ng-tns-c1605810258-313 ng-animate-disabled ng-trigger ng-trigger-codeBlockRevealAnimation" id="bkmrk--4"><div class="formatted-code-block-internal-container ng-tns-c1605810258-313"><div class="animated-opacity ng-tns-c1605810258-313"></div></div></div>Completely clear any auto-generated text and replace it with the following clean, accurate configuration block for Namecheap:
|
|
|
|
<div class="code-block ng-tns-c1605810258-314 ng-animate-disabled ng-trigger ng-trigger-codeBlockRevealAnimation" id="bkmrk-ini%2C-toml"><div class="formatted-code-block-internal-container ng-tns-c1605810258-314"><div class="animated-opacity ng-tns-c1605810258-314"><div class="code-block-decoration header-formatted gds-emphasized-body-m ng-tns-c1605810258-314 ng-star-inserted"><span class="ng-tns-c1605810258-314">Ini, TOML</span><div class="buttons ng-tns-c1605810258-314 ng-star-inserted"></div></div></div></div></div>```
|
|
# Configuration for Namecheap Dynamic DNS
|
|
protocol=namecheap
|
|
server=dynamicdns.park-your-domain.com
|
|
use=web, web=https://api.ipify.org
|
|
login=mikemcfetridge.com
|
|
password='your_namecheap_ddns_password'
|
|
@
|
|
|
|
```
|
|
|
|
<div class="code-block ng-tns-c1605810258-314 ng-animate-disabled ng-trigger ng-trigger-codeBlockRevealAnimation" id="bkmrk--7"><div class="formatted-code-block-internal-container ng-tns-c1605810258-314"><div class="animated-opacity ng-tns-c1605810258-314"></div></div></div>### 📋 Configuration Breakdown:
|
|
|
|
- **`server`**: Points directly to Namecheap's dedicated dynamic DNS handling infrastructure.
|
|
- **`use=web`**: Tells the client to fetch your external public IP using a web lookup utility (`ipify.org`) rather than checking your local router or network interface directly.
|
|
- **`login`**: Your root registered domain name.
|
|
- **`password`**: The unique, long alphanumeric DDNS password/token generated inside your Namecheap domain dashboard (this is *not* your Namecheap account password).
|
|
- **`@`**: Instructs `ddclient` to update the root domain apex itself. *(If you wanted to update a subdomain like `vpn.mikemcfetridge.com`, you would replace `@` with `vpn`).*
|
|
|
|
Save the file by pressing `CTRL + O`, then hit `Enter`, and exit the editor by pressing `CTRL + X`.
|
|
|
|
## 3. Managing the Service
|
|
|
|
Enable and start the background daemon process so that your system tracks and updates your IP automatically on reboots:
|
|
|
|
<div class="code-block ng-tns-c1605810258-315 ng-animate-disabled ng-trigger ng-trigger-codeBlockRevealAnimation" id="bkmrk-bash-2"><div class="formatted-code-block-internal-container ng-tns-c1605810258-315"><div class="animated-opacity ng-tns-c1605810258-315"><div class="code-block-decoration header-formatted gds-emphasized-body-m ng-tns-c1605810258-315 ng-star-inserted"><span class="ng-tns-c1605810258-315">Bash</span><div class="buttons ng-tns-c1605810258-315 ng-star-inserted"></div></div></div></div></div>```
|
|
# Enable the service to start automatically on system boot
|
|
sudo systemctl enable ddclient
|
|
|
|
# Start the service right now
|
|
sudo systemctl start ddclient
|
|
|
|
# Check the running operational status of the service
|
|
sudo systemctl status ddclient
|
|
|
|
```
|
|
|
|
<div class="code-block ng-tns-c1605810258-315 ng-animate-disabled ng-trigger ng-trigger-codeBlockRevealAnimation" id="bkmrk--10"><div class="formatted-code-block-internal-container ng-tns-c1605810258-315"><div class="animated-opacity ng-tns-c1605810258-315"></div></div></div>## 4. Verification and Debugging
|
|
|
|
To verify that your configuration is error-free and successfully communicating with Namecheap's servers, run a manual forced update simulation with verbose logging enabled:
|
|
|
|
<div class="code-block ng-tns-c1605810258-316 ng-animate-disabled ng-trigger ng-trigger-codeBlockRevealAnimation" id="bkmrk-bash-3"><div class="formatted-code-block-internal-container ng-tns-c1605810258-316"><div class="animated-opacity ng-tns-c1605810258-316"><div class="code-block-decoration header-formatted gds-emphasized-body-m ng-tns-c1605810258-316 ng-star-inserted"><span class="ng-tns-c1605810258-316">Bash</span><div class="buttons ng-tns-c1605810258-316 ng-star-inserted"></div></div></div></div></div>```
|
|
sudo ddclient -daemon=0 -debug -verbose -noquiet -force
|
|
|
|
```
|
|
|
|
<div class="code-block ng-tns-c1605810258-316 ng-animate-disabled ng-trigger ng-trigger-codeBlockRevealAnimation" id="bkmrk--13"><div class="formatted-code-block-internal-container ng-tns-c1605810258-316"><div class="animated-opacity ng-tns-c1605810258-316"></div></div></div>### Expected Output
|
|
|
|
Your terminal will print comprehensive initialization flags. Scroll down to the bottom of the output stream and verify that you see a `SUCCESS` confirmation similar to this:
|
|
|
|
<div class="code-block ng-tns-c1605810258-317 ng-animate-disabled ng-trigger ng-trigger-codeBlockRevealAnimation" id="bkmrk-plaintext"><div class="formatted-code-block-internal-container ng-tns-c1605810258-317"><div class="animated-opacity ng-tns-c1605810258-317"><div class="code-block-decoration header-formatted gds-emphasized-body-m ng-tns-c1605810258-317 ng-star-inserted"><span class="ng-tns-c1605810258-317">Plaintext</span><div class="buttons ng-tns-c1605810258-317 ng-star-inserted"></div></div></div></div></div>```
|
|
opt{daemon} : 0
|
|
opt{debug} : 1
|
|
...
|
|
RECEIVE: <debug><![CDATA[]]></debug>
|
|
RECEIVE: </interface-response>
|
|
SUCCESS: updating @: good: IP address set to 174.179.116.220
|
|
|
|
```
|
|
|
|
<div class="code-block ng-tns-c1605810258-317 ng-animate-disabled ng-trigger ng-trigger-codeBlockRevealAnimation" id="bkmrk--16"><div class="formatted-code-block-internal-container ng-tns-c1605810258-317"><div class="animated-opacity ng-tns-c1605810258-317"></div></div></div>If you see `SUCCESS: updating @: good`, your settings are valid, and `ddclient` is safely maintaining your public IP routing mapping behind the scenes! |