explaingit

community-scripts/proxmoxve

📈 Trending★ 27,923ShellAudience · ops devopsComplexity · 2/5ActiveLicenseSetup · hard

TLDR

One-command shell scripts that automate installing and configuring hundreds of self-hosted services (Home Assistant, Jellyfin, Pi-hole, etc.) on Proxmox VE virtual machines and containers.

Mindmap

mindmap
  root((repo))
    What it does
      Automates service setup
      Reduces manual config
      Supports two modes
      Post-install helpers
    Services covered
      Home automation
      Media servers
      Networking tools
      Monitoring stacks
    How it works
      Single command install
      Sensible defaults
      Advanced customization
      Config management
    Use cases
      Home lab setup
      Self-hosted infra
      Quick deployments
    Tech stack
      Shell scripts
      Proxmox VE
      Linux containers

Things people build with this

USE CASE 1

Set up a home media server (Jellyfin, Plex) on Proxmox with one command instead of manually installing packages and editing configs.

USE CASE 2

Deploy a complete home automation stack (Home Assistant, Zigbee2MQTT, Node-RED) across multiple containers with sensible defaults in under five minutes.

USE CASE 3

Add network monitoring and ad-blocking (Pi-hole, AdGuard Home) to your self-hosted infrastructure without hunting for dependencies.

USE CASE 4

Quickly spin up databases, security tools, or developer utilities on Proxmox containers and manage them via post-install helpers.

Tech stack

ShellProxmox VELinuxBash

Getting it running

Difficulty · hard Time to first run · 1day+

Requires Proxmox VE infrastructure, valid VM/container environment, and network access to download service dependencies.

Use freely for any purpose including commercial, as long as you keep the copyright notice.

In plain English

This repository is a community-run collection of helper scripts for Proxmox VE. Proxmox VE is a free, Debian-based operating system that you install on a server to run virtual machines and lightweight containers, and people often use it at home to run a "home lab" of self-hosted services. The problem the project solves is that installing each of those services normally means hunting for packages, editing configuration files, and gluing things together by hand. These scripts replace all that with one-line install commands that you paste into your Proxmox shell. The workflow described in the README is simple: go to community-scripts.org, search for the service you want such as Home Assistant, Nginx Proxy Manager, or Jellyfin, copy the one-line install command from its page, paste it into the Proxmox shell, and answer a few prompts. Each script offers two modes. Default mode picks sensible defaults for CPU, RAM, and storage and only asks the bare minimum, so most installs finish in under five minutes. Advanced mode hands you full control over container settings, networking, storage backends, and application configuration. After install, each container also includes a post-install helper for updates, settings changes, and basic troubleshooting. The collection covers hundreds of services across categories such as 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), and dev tools (Gitea, Portainer, VS Code Server, n8n). You would use this project if you are running Proxmox VE versions 8.4, 9.0, or 9.1 on your own hardware and want a fast, repeatable way to spin up self-hosted apps without becoming an expert in each one's install procedure. The scripts are shell scripts and require root shell access on the Proxmox host plus an internet connection during install. It is MIT-licensed and built on the foundation of an earlier project by @tteck.

Copy-paste prompts

Prompt 1
I want to install Home Assistant on Proxmox VE. Show me how to use the community-scripts/proxmoxve helper script to do it in one command.
Prompt 2
How do I use the advanced mode in proxmoxve scripts to customize CPU, RAM, and storage before installing a service?
Prompt 3
I need to set up Jellyfin media server on Proxmox. Walk me through using the proxmoxve script and explain what the post-install helper does.
Prompt 4
Show me how to use proxmoxve to deploy Pi-hole for network-wide ad blocking on my Proxmox home lab.
Prompt 5
What services does the proxmoxve collection support, and how do I pick the right script for my self-hosted setup?
Open on GitHub → Explain another repo

Generated 2026-05-21 · Model: sonnet-4-6 · Verify against the repo before relying on details.