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.8K ·GitHub
Что это такое?Набор скриптов установки в одну команду, поддерживаемый сообществом, для Proxmox VE: вставляете одну строку в shell Proxmox — и скрипт сам разворачивает популярный self-hosted сервис в виде готового контейнера или виртуальной машины.
Это приложение, которое я устанавливаю на свой компьютер, или что-то другое?Ни то, ни другое — это набор shell-скриптов плюс сайт-каталог (community-scripts.org). Скрипты запускаются в shell вашего сервера Proxmox VE, и каждый из них создаёт и настраивает LXC-контейнер или виртуальную машину.
Как с его помощью что-то установить?Найдите нужный сервис на community-scripts.org, скопируйте его однострочную команду установки и вставьте её в shell Proxmox. На странице каждого скрипта указано, что входит в контейнер, какие у него ресурсы по умолчанию и что нужно сделать после установки.
Что нужно серверу, чтобы запускались эти скрипты?Хост Proxmox VE версии 8.4, 9.0, 9.1 или 9.2 с root-доступом к shell, а также интернет-соединение на время установки.
Скрипты работают на любом Linux-сервере или только на Proxmox?Только на самом Proxmox VE — они рассчитаны на shell хоста Proxmox VE (на базе Debian) и разворачивают на нём 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 даёт полный контроль над настройками контейнера, сетью, хранилищами и конфигурацией приложения ещё до установки.
После установки контейнера придётся настраивать приложение самому?Нет — в каждом контейнере есть постустановочный помощник, который открывается из shell Proxmox. Он накатывает обновления сервиса, меняет настройки приложения без ручного редактирования конфигов и даёт базовые средства диагностики и доступ к логам.
Какая история у этого проекта?Он продолжает знаменитые helper-скрипты покойного tteck, а теперь поддерживается и развивается командой волонтёров. Проект распространяется по лицензии MIT и бесплатен, а 30% всех пожертвований напрямую направляются на исследования рака и хосписную помощь в память о tteck.
Size
45.5 MB
Stars
29.8K
Age
1y
Commits · 90 Days