diff --git a/extensions/Servers/Proxmox/views/help.blade.php b/extensions/Servers/Proxmox/views/help.blade.php index 992dc687e..95634a070 100644 --- a/extensions/Servers/Proxmox/views/help.blade.php +++ b/extensions/Servers/Proxmox/views/help.blade.php @@ -35,7 +35,7 @@ this.expandedCategories[key] = true; }); // Auto-switch to first matching section - const sections = ['overview', 'quick-start', 'boot-settings', 'network', 'subdomain', 'cloud-init', 'display', 'statistics', 'system', 'backups', 'console', 'bgp', 'glossary', 'rfc-standards', 'troubleshooting']; + const sections = ['overview', 'quick-start', 'reinstall', 'boot-settings', 'network', 'subdomain', 'cloud-init', 'display', 'statistics', 'system', 'backups', 'console', 'bgp', 'glossary', 'rfc-standards', 'troubleshooting']; for (const section of sections) { const sectionElement = document.querySelector(`[data-section-id='${section}']`); if (sectionElement) { @@ -99,6 +99,13 @@ Quick Start Guide + @@ -316,6 +323,163 @@ + +
+
+
+ +
+

How to Reinstall

+
+ +

+ Learn how to reinstall your virtual machine with a fresh operating system. Reinstalling will completely wipe your current installation and install a new OS from scratch. +

+ +
+
+ +
+

Important: Data Loss Warning

+
    +
  • All data will be permanently deleted - This includes files, applications, configurations, and user data
    • +
  • Backups are not automatically restored - Make sure to restore any needed data from backups after reinstallation
    • +
  • IP addresses are preserved - Your assigned IP addresses will remain the same
    • +
  • Network configuration is reset - You may need to reconfigure network settings after reinstall
    • +
+
+
+
+ +
+
+

+ 1 + Before You Begin +

+
    +
  1. Backup important data - Download or backup any files, databases, or configurations you need to keep
    2. +
  2. Document your current configuration - Note down network settings, installed packages, and custom configurations
    3. +
  3. Verify server protection status - Some servers may have reinstall protection enabled (contact support if needed)
    4. +
  4. Ensure you have console access - You'll need NoVNC or Xterm.js access to complete the installation
    5. +
+
+ +
+

+ 2 + Accessing the Reinstall Feature +

+
    +
  1. Navigate to the Overview tab of your server
    2. +
  2. Scroll down to find the "Reinstall Server" button (usually in the server management section)
    3. +
  3. Click the button to open the reinstall dialog
    4. +
  4. If the button is disabled or shows a warning, your server may be protected - contact support
    5. +
+
+ +
+

+ 3 + Selecting an Operating System +

+

+ The reinstall dialog displays available operating system templates organized by category: +

+
    +
  • Ubuntu - Popular Linux distribution with LTS (Long Term Support) versions
    • +
  • Debian - Stable, community-driven Linux distribution
    • +
  • CentOS / Enterprise / RHEL Family - Enterprise Linux distributions (AlmaLinux, Rocky Linux, Oracle Linux)
    • +
  • Community & Rolling - Fedora, Arch Linux, openSUSE, Gentoo
    • +
  • Lightweight - Alpine Linux for minimal resource usage
    • +
  • BSD Family - FreeBSD, NetBSD, OpenBSD
    • +
  • Windows Server - Microsoft Windows Server editions
    • +
  • Proxmox Hypervisor - Proxmox VE for virtualization hosts
    • +
+

+ Tip: Look for "Recommended" badges on certain OS versions for best compatibility and support. +

+
+ +
+

+ 4 + Confirming the Reinstall +

+
    +
  1. Select your desired operating system from the list
    2. +
  2. Review the warning message about data loss
    3. +
  3. Check the confirmation checkbox to acknowledge data will be deleted
    4. +
  4. Click "Reinstall" to begin the process
    5. +
  5. You will be redirected to the servers list - the reinstall happens in the background
    6. +
+
+ +
+

+ 5 + During Reinstallation +

+

+ The reinstall process typically takes 5-15 minutes and involves: +

+
    +
  • Stopping the current virtual machine
    • +
  • Deleting the existing VM configuration and disk
    • +
  • Creating a new VM with the selected OS template
    • +
  • Installing the operating system from scratch
    • +
  • Configuring network settings with your assigned IP addresses
    • +
  • Setting up initial user credentials (password will be generated and sent via notification)
    • +
+
+ +
+

+ 6 + After Reinstallation +

+
    +
  1. Check your notifications - You'll receive a notification with the new root/admin password
    2. +
  2. Access the console - Use NoVNC or Xterm.js to access the new installation
    3. +
  3. Verify network connectivity - Check that IP addresses are configured correctly
    4. +
  4. Update the system - Run system updates: apt update && apt upgrade (Debian/Ubuntu) or equivalent
    5. +
  5. Restore your data - Restore files and configurations from your backups
    6. +
  6. Reconfigure services - Set up applications, web servers, databases, etc.
    7. +
  7. Update Cloud-init settings - Configure hostname, SSH keys, and other settings in the Cloud-init tab
    8. +
+
+ +
+

+ + Frequently Asked Questions +

+
+
+

Will my IP addresses change?

+

No, your assigned IP addresses (both IPv4 and IPv6) will remain the same after reinstallation.

+
+
+

Can I cancel a reinstall once it starts?

+

No, once the reinstall process begins, it cannot be cancelled. The old VM is deleted immediately.

+
+
+

What if my server shows "Protected" status?

+

Protected servers have reinstall disabled for safety. Contact support to enable reinstall if needed.

+
+
+

Will my backups be deleted?

+

No, existing backups are preserved. However, you'll need to manually restore data from backups after reinstall.

+
+
+

How long does reinstallation take?

+

Typically 5-15 minutes depending on the OS template size and server resources. You'll receive a notification when complete.

+
+
+
+
+
+