Initial commit: homelab configuration and documentation

docs/guides/proxmox_network_fix.md

@@ -0,0 +1,39 @@
+# Proxmox USB Network Adapter Fix
+
+This document outlines a solution to the intermittent network disconnection issue on the Acer Proxmox host, where the USB network adapter drops its connection and does not reconnect automatically.
+
+## The Problem
+
+The Acer Proxmox host (`192.168.1.57`) uses a USB-to-Ethernet adapter for its 2.5 GbE connection. This adapter occasionally disconnects and fails to reconnect on its own, disrupting network access for the host and its VMs.
+
+## The Solution
+
+A shell script, `network_check.sh`, has been created to monitor the network connection. If the connection is down, the script will attempt to reset the USB adapter. If that fails, it will reboot the host to restore connectivity. This script is intended to be run as a cron job at regular intervals.
+
+### 1. The `network_check.sh` Script
+
+The script performs the following actions:
+1.  Pings a reliable external IP address (e.g., `8.8.8.8`) to check for internet connectivity.
+2.  If the ping fails, it identifies the USB network adapter's bus and device number.
+3.  It then attempts to reset the USB device.
+4.  If the network connection is still not restored after resetting the adapter, the script will force a reboot.
+
+The script is located at `/usr/local/bin/network_check.sh`.
+
+### 2. Cron Job Setup
+
+To automate the execution of the script, a cron job should be set up to run every 5 minutes.
+
+**To add the cron job, follow these steps:**
+
+1.  Open the crontab editor:
+    ```bash
+    crontab -e
+    ```
+2.  Add the following line to the file:
+    ```
+    */5 * * * * /bin/bash /usr/local/bin/network_check.sh
+    ```
+3.  Save and exit the editor.
+
+This will ensure that the network connection is checked every 5 minutes, and the appropriate action is taken if a disconnection is detected.