diff --git a/README.MD b/README.MD
new file mode 100644
index 0000000..6041bf2
--- /dev/null
+++ b/README.MD
@@ -0,0 +1,44 @@
+# Proxmox LVM Automatic Full Resize Script
+
+## Overview
+
+This script automatically resizes the root logical volume on a Proxmox host to utilize the full capacity of the underlying disk. It is designed for systems using the default LVM layout on `/dev/vda`.  
+
+The script performs the following steps:
+
+1. Checks prerequisites (root access, disk, and LVM tools).  
+2. Installs `growpart` if it is not present.  
+3. Expands the `/dev/vda3` partition.  
+4. Resizes the LVM physical volume.  
+5. Extends the root logical volume (`/dev/pve/root`) to use all free space.  
+6. Resizes the filesystem to make the additional space available.  
+
+The script gracefully handles cases where the partition or logical volume is already at maximum size and provides informative output messages.
+
+---
+
+## Prerequisites
+
+- You are logged in to your Proxmox host via SSH as the `root` user.  
+- Your Proxmox installation uses the default LVM storage layout on `/dev/vda`.  
+
+---
+
+## Usage
+
+### Run Directly from Gitea
+
+```bash
+curl -fsSL https://gitea.virtnet.bond/Joey/pve-lvm-automatic-full-resize/raw/branch/main/script.sh | bash
+
+
+### Notes
+
+The script is safe to run multiple times; it will detect if partitions or logical volumes are already at maximum size.
+
+Ensure you have proper backups before modifying partitions or LVM volumes.
+
+Compatible with Debian-based Proxmox hosts.
+
+### License
+This script is provided "as-is" without warranty. Use at your own risk.
\ No newline at end of file