Update Changelog

CHANGELOG.md

@@ -1,3 +1,30 @@
+## 2025-05-04
+
+### Added
+- **Interactive Help & Info Menu**  
+  Added a new script called `Help and Info`, which provides an interactive command reference menu for Proxmox VE through a dialog-based interface.  
+  This tool offers users a quick way to browse and copy useful commands for managing and maintaining their Proxmox server, all in one centralized location.
+
+  ![Help and Info Menu](https://macrimi.github.io/ProxMenux/help/help-info-menu.png)
+
+  *Figure 1: Help and Info interactive command reference menu.*
+
+- **Uninstaller for Post-Install Utilities**  
+  A new script has been added to the **Post-Installation** menu, allowing users to uninstall utilities or packages that were previously installed through the post-install script.
+
+### Improved
+- **Utility Selection Menu in Post-Installation Script**  
+  The `Install Common System Utilities` section now includes a menu where users can choose which utilities to install, instead of installing all by default. This gives more control over what gets added to the system.
+
+- **Old PV Header Detection and Auto-Fix**  
+  After updating the system, the post-update script now includes a security check for physical disks with outdated LVM PV (Physical Volume) headers.  
+  This issue can occur when virtual machines have passthrough access to disks and unintentionally modify volume metadata. The script now detects and automatically updates these headers.  
+  If any error occurs during the process, a warning is shown to the user.
+
+- **Faster Translations in Menus**  
+  Several post-installation menus with auto-translations have been optimized to reduce loading times and improve user experience.
+
+
 ## 2025-04-14
 
 ### Added

web/app/docs/help-info/page.tsx

@@ -16,6 +16,36 @@ import {
   Book,
 } from "lucide-react"
 
+
+export const metadata: Metadata = {
+  title: "ProxMenux Documentation: Help and Info",
+  description:
+    "Comprehensive collection of useful commands and references for Proxmox VE, organized by category for easy access and quick reference.",
+  openGraph: {
+    title: "ProxMenux Documentation: Help and Info",
+    description:
+      "Comprehensive collection of useful commands and references for Proxmox VE, organized by category for easy access and quick reference.",
+    type: "article",
+    url: "https://macrimi.github.io/ProxMenux/docs/help-info",
+    images: [
+      {
+        url: "https://macrimi.github.io/ProxMenux/help/help-info-menu.png",
+        width: 1200,
+        height: 630,
+        alt: "ProxMenux Help and Info Menu",
+      },
+    ],
+  },
+  twitter: {
+    card: "summary_large_image",
+    title: "ProxMenux Documentation: Help and Info",
+    description:
+      "Comprehensive collection of useful commands and references for Proxmox VE, organized by category for easy access and quick reference.",
+    images: ["https://macrimi.github.io/ProxMenux/help/help-info-menu.png"],
+  },
+}
+
+
 interface ImageWithCaptionProps {
   src: string
   alt: string

web/app/docs/post-install/basic-settings/page.tsx

@@ -54,19 +54,23 @@ export default function BasicSettingsPage() {
 
       <h3 className="text-xl font-semibold mt-16 mb-4 flex items-center">
         <StepNumber number={1} />
-        Install Common System Utilities
+        Select and Install System Utilities
       </h3>
       <p className="mb-4">
-        This optimization installs a set of common system utilities that are useful for system administration and
+        This option presents a menu where you can select which system utilities to install based on your needs.
-        troubleshooting.
       </p>
-      <p className="mb-4">
+
-      <strong className="block">Why it's beneficial:</strong>
+      
-        Having these utilities pre-installed saves time when managing your Proxmox
+      <div className="mb-6">
-        VE system. They provide essential tools for monitoring system performance, managing files, and troubleshooting
+        <img
-        issues, enhancing your ability to maintain and optimize your virtualization environment.
+          src="https://macrimi.github.io/ProxMenux/basic/menu_utilities.png"
-      </p>
+          alt="System Utilities Selection Menu"
-      <h4 className="text-lg font-semibold mb-2">Utilities installed:</h4>
+          className="rounded shadow-lg border border-gray-200"
+        />
+        <p className="text-sm text-gray-600 mt-2 text-center">The utilities selection menu allows you to choose which tools to install</p>
+      </div>
+      
+      <h4 className="text-lg font-semibold mb-2">Available utilities:</h4>
       <ul className="list-disc pl-5 mb-4 space-y-12">
 
       <li>
@@ -292,20 +296,20 @@ sudo timedatectl set-timezone "$TIMEZONE"
         `}
       />
 
-      <h3 className="text-xl font-semibold mt-16 mb-4 flex items-center">
+<h3 className="text-xl font-semibold mt-16 mb-4 flex items-center">
         <StepNumber number={4} />
         Update and Upgrade System
       </h3>
       <p className="mb-4">
         This optimization updates the system's package lists, upgrades installed packages, and configures Proxmox
-        repositories. It also includes additional steps to properly set up Debian repositories and disable certain
+        repositories. It also includes additional steps to properly set up Debian repositories, disable certain
-        warnings.
+        warnings, and perform safety checks after the update process.
       </p>
       <p className="mb-4">
       <strong className="block">Why it's beneficial:</strong>
         Keeping your system up-to-date is essential for security, stability, and
         performance. This optimization ensures you have the latest patches and features, while also configuring the
-        correct repositories for Proxmox VE, enabling access to necessary updates and tools.
+        correct repositories for Proxmox VE, enabling access to necessary updates and tools. The disk metadata check helps prevent potential issues with storage devices that may have been modified by virtual machines.
       </p>
       <h4 className="text-lg font-semibold mb-2">Repository changes:</h4>
       <ul className="list-disc pl-5 mb-4 space-y-2">
@@ -363,16 +367,19 @@ pveam update
 # Install additional packages
 sudo apt-get install -y zfsutils-linux proxmox-backup-restore-image chrony
   `}
-      />
+/>
-
+<div className="mt-6 p-4 bg-blue-50 border-l-4 border-blue-500 rounded-md">
-      <section className="mt-12 p-4 bg-blue-100 rounded-md">
+        <h4 className="text-lg font-semibold mb-2 text-black">Post-Update Safety Check</h4>
-        <h2 className="text-xl font-semibold mb-2">Automatic Application</h2>
+        <p className="text-gray-700 mb-2">
-        <p>
+          After updating the system, the script performs an important safety check to detect disks with old PV (Physical Volume) headers that might have been modified by virtual machines.
-          All of these optimizations are automatically applied when selected in the Basic Settings section. This
-          automation ensures that these beneficial settings are applied consistently and correctly, saving time and
-          reducing the potential for human error during manual configuration.
         </p>
-      </section>
+        <p className="text-gray-700 mb-2">
+          <strong>Why this matters:</strong> When VMs have direct access to disks through passthrough, they can sometimes modify the disk metadata. This can cause issues with storage management on the host system, potentially leading to data access problems or errors when using LVM (Logical Volume Manager).
+        </p>
+        <p className="text-gray-700">
+          If any issues are detected, the script will display a warning message and suggest running the <code className="bg-gray-100 px-1 py-0.5 rounded text-black">pvs</code> command to identify the affected disks. This early detection helps prevent potential storage problems before they impact your system.
+        </p>
+      </div>
     </div>
   )
 }

web/app/docs/post-install/page.tsx

@@ -47,10 +47,9 @@ export default function PostInstallPage() {
     <div className="container mx-auto px-4 py-8">
       <h1 className="text-3xl font-bold mb-6">ProxMenux Post-Install Script Documentation</h1>
       <p className="mb-4">
-        The <strong>Customizable Post-Install Script</strong> is a utility designed to optimize 
+        The <strong>Customizable Post-Install Script</strong> is a utility designed to optimize the installation of
-        the installation of Proxmox VE by adjusting system configurations. One of the advantages of 
+        Proxmox VE by adjusting system configurations. One of the advantages of its modular and selectable structure is
-        its modular and selectable structure is that it allows users to choose specific settings based on 
+        that it allows users to choose specific settings based on their requirements, needs, and preferences.
-        their requirements, needs, and preferences.
       </p>
       <p className="mb-4">
         This script is primarily based on the work of{" "}
@@ -60,10 +59,13 @@ export default function PostInstallPage() {
         and the{" "}
         <Link href="https://github.com/community-scripts/ProxmoxVE" className="text-blue-500 hover:underline">
           Proxmox VE Post Install script from Proxmox VE Helper-Scripts
-      </Link>.  
+        </Link>
+        .
+      </p>
+      <p className="mb-6">
+        This script includes {categories.length} main categories, each targeting a key aspect of Proxmox VE performance,
+        security, and usability:
       </p>
-      <p className="mb-6">This script includes {categories.length} main categories, each targeting a key aspect of Proxmox VE
-        performance, security, and usability:</p>
       <ul className="list-disc pl-5 mb-6">
         {categories.map((category) => (
           <li key={category.order} className="mb-2">
@@ -76,29 +78,43 @@ export default function PostInstallPage() {
           </li>
         ))}
       </ul>
-      <p>
+      <p className="mb-6">
         Each category includes selectable options, ensuring that users can tailor the system adjustments to their
         specific needs without applying unnecessary modifications. Click on a category to explore available settings.
       </p>
 
-      <div className="bg-yellow-100 border-l-4 border-yellow-500 text-yellow-700 p-4 mt-16 mb-4">
+      <div className="bg-green-100 border-l-4 border-green-500 text-green-800 p-4 mb-6">
+        <p className="font-semibold mb-2">Uninstall Option</p>
+        <p className="mb-2">
+          The Post-Install Menu Script now includes an option to uninstall packages and utilities that were previously
+          installed by the script. This feature allows you to:
+        </p>
+        <ul className="list-disc pl-5">
+          <li>Remove specific utilities that are no longer needed</li>
+        </ul>
+      </div>
+
+      <div className="bg-yellow-100 border-l-4 border-yellow-500 text-yellow-700 p-4 mb-4">
         <p className="font-semibold">Important: Avoid Running Multiple Post-Install Scripts</p>
         <p>
-          It is not recommended to use different post-installation scripts, as this can cause conflicts by overwriting or duplicating files and settings.
+          It is not recommended to use different post-installation scripts, as this can cause conflicts by overwriting
+          or duplicating files and settings.
         </p>
         <ul className="list-disc pl-5">
           <li>
-            The <strong>ProxMenux Post-Install Script</strong> is designed to avoid overwriting existing configurations where possible.
+            The <strong>ProxMenux Post-Install Script</strong> is designed to avoid overwriting existing configurations
+            where possible.
           </li>
           <li>
-            If you have already run the <strong>eXtremeSHOK Post-Install Script</strong>, there is no need to run the ProxMenux Post-Install Script again, except for <strong>Option 35</strong> (console customization).
+            If you have already run the <strong>eXtremeSHOK Post-Install Script</strong>, there is no need to run the
+            ProxMenux Post-Install Script again, except for <strong>Option 35</strong> (console customization).
           </li>
           <li>
-            If you have used the <strong>Helper-Scripts Post-Install Script</strong>, you can run all ProxMenux options <strong>except for options 4 and 27</strong>, as they will already be configured.
+            If you have used the <strong>Helper-Scripts Post-Install Script</strong>, you can run all ProxMenux options{" "}
+            <strong>except for options 4 and 27</strong>, as they will already be configured.
           </li>
         </ul>
       </div>
     </div>
   )
 }
-