+
+
+
+ > **Simplify your Proxmox VE setup with community-driven automation scripts**
+ > Originally created by tteck, now maintained and expanded by the community
+
+
+
+
+
+
+ ๐ Shoutout to
+
+
+
+
+
+
+ View on GitHub โข Consistent, beautiful icons for 5000+ self-hosted apps
---
-## ๐ Project Overview
+## ๐ฏ Key Features
-**Proxmox VE Helper-Scripts** is a collection of tools to simplify the setup and management of Proxmox Virtual Environment (VE). Originally created by [tteck](https://github.com/tteck), these scripts are now continued by the community. Our goal is to preserve and expand upon tteck's work, providing an ongoing resource for Proxmox users worldwide.
+
+
+
+
+
+
โก Quick Setup
+
One-command installations for popular services and containers
+
+
+
โ๏ธ Flexible Config
+
Simple mode for beginners, advanced options for power users
+
+
+
๐ Auto Updates
+
Keep your installations current with built-in update mechanisms
+
+
+
๐ ๏ธ Easy Management
+
Post-install scripts for configuration and troubleshooting
+
+
+
+
+
๐ฅ Community Driven
+
Actively maintained with contributions from users worldwide
+
+
+
๐ Well Documented
+
Comprehensive guides and community support
+
+
+
๐ Secure
+
Regular security updates and best practices
+
+
+
โก Performance
+
Optimized configurations for best performance
+
+
+
+
+
---
-## ๐ฆ Features
+## ๐ Requirements
-- **Interactive Setup**: Choose between simple and advanced options for configuring VMs and LXC containers.
-- **Customizable Configurations**: Advanced setup for fine-tuning your environment.
-- **Seamless Integration**: Works seamlessly with Proxmox VE for a smooth experience.
-- **Community-driven**: Actively maintained and improved by the Proxmox community.
+
----
-## โ Requirements
+
+
+
+
๐ฅ๏ธ Proxmox VE
+
Version 8.4.x or 9.0.x
+
+
+
๐ง Operating System
+
Debian-based with Proxmox Tools
+
+
+
๐ Network
+
Internet connection required
+
+
+
-Ensure your system meets the following prerequisites:
-
-- **Proxmox VE version**: 8.x or higher
-- **Linux**: Compatible with most distributions
-- **Dependencies**: bash and curl should be installed.
+
---
-## ๐ Installation
+## ๐ฅ Getting Started
-To install the Proxmox Helper Scripts, follow these steps:
+Choose your preferred installation method:
-1. Visit the [Website](https://helper-scripts.com/).
-2. Search for the desired script, e.g., **"Home Assistant OS VM"**.
-3. Copy the provided **Bash command** from the **"How To Install"** section.
-4. Open the Proxmox shell on your **main node** and paste the command.
-5. Press enter to start the installation! ๐
+### Method 1: One-Click Web Installer
+
+The fastest way to get started:
+
+1. Visit **[helper-scripts.com](https://helper-scripts.com/)** ๐
+2. Search for your desired script (e.g., "Home Assistant", "Docker")
+3. Copy the bash command displayed on the script page
+4. Open your **Proxmox Shell** and paste the command
+5. Press Enter and follow the interactive prompts
+
+### Method 2: PVEScripts-Local
+
+Install a convenient script manager directly in your Proxmox UI:
+
+```bash
+bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/pve-scripts-local.sh)"
+```
+
+This adds a menu to your Proxmox interface for easy script access without visiting the website.
+
+๐ **Learn more:** [ProxmoxVE-Local Repository](https://github.com/community-scripts/ProxmoxVE-Local)
---
-## โค๏ธ Community and Contributions
+## ๐ฌ Join the Community
-We appreciate any contributions to the projectโwhether it's bug reports, feature requests, documentation improvements, or spreading the word. Your involvement helps keep the project alive and sustainable.
+
-## ๐ Donate to Support the Project
-- **Ko-Fi for Community Edition**: [Donate to support this project](https://ko-fi.com/community_scripts) โ Donations go towards maintaining the project, testing infrastructure, and charity (cancer research, hospice care). 30% of the funds will be donated to charity.
+
-If you encounter any issues or have suggestions for improvement, file a new issue on our [GitHub issues page](https://github.com/community-scripts/ProxmoxVE/issues). You can also submit pull requests with solutions or enhancements!
+
+
+
+ ๐ Check our **[Contributing Guidelines](https://github.com/community-scripts/ProxmoxVE/blob/main/.github/CONTRIBUTOR_AND_GUIDES/CONTRIBUTING.md)** to get started
+
+