ProxmoxVE README

The project's README from github.com/community-scripts/ProxmoxVE. As one markdown file: README.md.

Proxmox VE Helper-Scripts Logo

Proxmox VE Helper-Scripts

One-command installations for services, containers, and VMs on Proxmox VE
A community project — built on the foundation of @tteck's original work

What is this?

Simplify your Proxmox VE setup with community-driven automation scripts.

Install and configure popular self-hosted services with a single command — no manual package hunting, no config file archaeology. Paste a command into your Proxmox shell, answer a few prompts, and your container or VM is up and running.

The collection covers hundreds of services across categories like home automation, media servers, networking tools, databases, monitoring stacks, and more.

Requirements

Component Details
Proxmox VE Version 8.4, 9.0, 9.1, or 9.2
Host OS Proxmox VE (Debian-based)
Access Root shell access on the Proxmox host
Network Internet connection required during installation

Getting Started

The fastest way to find and run scripts:

  1. Go to community-scripts.org
  2. Search for the service you want (e.g. "Home Assistant", "Nginx Proxy Manager", "Jellyfin")
  3. Copy the one-line install command from the script page
  4. Open your Proxmox Shell and paste it
  5. Choose between Default or Advanced setup and follow the prompts

Each script page documents what the container includes, default resource allocation, and post-install notes.

How Scripts Work

Every script follows the same pattern:

Default mode — Picks sensible resource defaults (CPU, RAM, storage) and asks only the minimum required questions. Most installs finish in under five minutes.

Advanced mode — Gives you full control over container settings, networking, storage backends, and application-level configuration before anything is installed.

After installation, each container ships with a post-install helper accessible from the Proxmox shell. It handles common tasks like:

What's Included

The repository covers a wide range of categories. A few examples:

Category Examples
Home Automation Home Assistant, Zigbee2MQTT, ESPHome, Node-RED
Media Jellyfin, Plex, Radarr, Sonarr, Immich
Networking AdGuard Home, Nginx Proxy Manager, Pi-hole, Traefik
Monitoring Grafana, Prometheus, Uptime Kuma, Netdata
Databases PostgreSQL, MariaDB, Redis, InfluxDB
Security Vaultwarden, CrowdSec, Authentik
Dev & Tools Gitea, Portainer, VS Code Server, n8n

Browse the full list at community-scripts.org/categories — new scripts are added regularly.

Contributing

This project runs on community contributions. Whether you want to write new scripts, improve existing ones, or just report a bug — every bit helps.

Where to start

I want to… Go here
Add a new script ProxmoxVED — new scripts are tested here first
Fix or improve an existing script Contributing Guidelines — open a PR in this repo
Report a bug or broken script Issues
Request a new script or feature Discussions
Report a security vulnerability Security Policy
Get help or chat with other users Discord

Before you open a PR

Core Team

MickLesk
MickLesk 		michelroegl-brunner
michelroegl-brunner 		BramSuurdje
BramSuurdje 		CrazyWolf13
CrazyWolf13 		tremor021
tremor021 		vhsdream
vhsdream 		asylumexp
asylumexp

Project Activity

Repository activity

Star History Chart

Support the Project

This project is maintained by volunteers. All infrastructure costs come out of pocket, and the work is done in people's spare time.

30% of all donations are forwarded directly to cancer research and hospice care — a cause that was important to tteck.

Support on Ko-fi   Donate via community-scripts.org

License

This project is licensed under the MIT License — free to use, modify, and redistribute for personal and commercial purposes.

See the full license text in LICENSE.

Built on the foundation of tteck's original work · Original Repository
Maintained and expanded by the community · In memory of tteck
Proxmox® is a registered trademark of Proxmox Server Solutions GmbH

ProxmoxVE (community-scripts/ProxmoxVE)

Searching Database…

29.9K ·GitHub
ProxmoxVE
这是什么？一套由社区维护的 Proxmox VE 一键安装脚本：把单行命令粘贴到你的 Proxmox shell 里，它就会自动装好一个流行的自托管服务，生成一个开箱即用的容器或虚拟机。
这是要装在我电脑上的应用，还是别的东西？都不是——它是一批 shell 脚本，外加一个目录网站（community-scripts.org）。脚本在你的 Proxmox VE 服务器的 shell 里运行，每条脚本会在上面创建并配置一个 LXC 容器或虚拟机。
怎么用它安装东西？在 community-scripts.org 上找到你想装的服务，复制它的一行安装命令，然后粘贴到 Proxmox shell 里。每个脚本的页面上会列出容器包含哪些内容、默认资源分配，以及安装后的注意事项。
运行这些脚本之前，服务器需要满足什么条件？一台版本为 8.4、9.0、9.1 或 9.2 的 Proxmox VE 主机，并且能用 root 身份进入 shell，另外安装期间需要联网。
这些脚本能装在任何 Linux 服务器上，还是只能在 Proxmox 上用？只能在 Proxmox VE 上用——这些脚本针对的是 Proxmox VE 主机（基于 Debian）的 shell，并在其上创建 LXC 容器或虚拟机，所以普通的 Debian 机器或其他虚拟化平台都不行。
它到底能安装哪些东西？涵盖多种类别的数百个服务：家庭自动化有 Home Assistant 和 Zigbee2MQTT，媒体方面有 Jellyfin 和 Immich，网络方面有 AdGuard Home 和 Nginx Proxy Manager，监控方面有 Grafana 和 Uptime Kuma，此外还有各类数据库、Vaultwarden、Gitea 和 n8n。完整列表见 community-scripts.org/categories。
Default 和 Advanced 两种安装方式有什么区别？Default 会自动选择合理的 CPU、内存和存储数值，只问最少的问题——大多数安装五分钟内就能完成。Advanced 则让你在安装前完全掌控容器的各项设置、网络、存储后端和应用配置。
容器装好之后，应用还得我自己配置吗？不用——每个容器都自带一个安装后助手，从 Proxmox shell 里就能打开。它会应用服务更新，无需手动改配置文件就能修改应用设置，还提供基本的故障排查和日志查看功能。
这个项目背后有什么故事？它延续了已故的 tteck 那套著名的 helper scripts，现在由一个志愿者团队维护和扩展。项目采用 MIT 许可证、完全免费，并且所有捐款的 30% 会直接捐给癌症研究和临终关怀机构，以纪念 tteck。
What are similar projects?Proxmox, zsvirt, distrobox, macos, openvpn-install, reinstall, Docker-OSX, nvx
Which topics is it in?alpine, proxmox, hypervisor, scripts, media-server, container, debian, kvm, home-assistant, vm, ubuntu, home-automation
Creator
community-scripts
Size
45.5 MB
Stars
29.9K
Updated
CommitOct 20Release2026-10-20Oct 21
Age
1y
Commits · 90 Days