diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..faeeb6e
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,58 @@
+# Universal Proxmox Subscription Nag Remover
+
+A standalone script to remove the Proxmox subscription warning from the web interface.  
+Supports **Proxmox VE (PVE)**, **Proxmox Backup Server (PBS)**, and **Proxmox Mail Gateway (PMG)**.  
+Fixes persist across updates and are reapplied automatically.
+
+---
+
+## Features
+
+- ✅ Works with PVE, PBS, and PMG
+- ✅ Automatically detects your Proxmox product
+- ✅ Applies the correct patch for each product
+- ✅ Persists across updates via APT hook
+- ✅ Supports both desktop and mobile interfaces (PMG)
+- ✅ Based on `tteck`'s community scripts, but self-contained
+
+---
+
+## Usage
+
+Run as root:
+
+```bash
+sudo ./remove-proxmox-nag.sh
+```
+
+You’ll be prompted before continuing.  
+The patch modifies `proxmoxlib.js` and installs an `apt.conf.d` script to automatically reapply after upgrades.
+
+---
+
+## To Reinstall or Reapply
+
+Delete the APT hook and rerun the script:
+
+```bash
+sudo rm /etc/apt/apt.conf.d/no-nag-script
+sudo ./remove-proxmox-nag.sh
+```
+
+---
+
+## Note on Ethics
+
+This script removes only the **UI nag banner**.  
+It does *not* interfere with any core functionality or licensing checks.
+
+> If you use Proxmox in production, please consider purchasing a subscription.  
+> This script is intended only for personal, homelab, and non-commercial educational use.
+
+---
+
+## License
+
+MIT License  
+Copyright (c) 2021–2025  
+Based on [tteck's community-scripts](https://community-scripts.github.io/ProxmoxVE/)
\ No newline at end of file