* feat: add Docker-based tool addons for dockge, komodo, dokploy, npmplus Create addon scripts following the arcane.sh pattern for Docker-based tools that can be installed on any existing Docker LXC: - dockge: Docker Compose stack manager (port 5001) - komodo: Build/deployment system with MongoDB/FerretDB (port 9120) - dokploy: PaaS via external installer with Redis (port 3000) - npmplus: Nginx Proxy Manager Plus via Compose (port 81) Each addon includes: - Docker availability check - Install with full configuration - Update via docker compose pull - Uninstall with container cleanup - ASCII header files Original ct/ and install/ scripts are preserved for now. * refactor: convert Docker tools to addons, remove old scripts Convert dockge, komodo, dokploy, coolify from standalone ct/install scripts to addon pattern (like arcane.sh). Added: - tools/addon/dockge.sh (port 5001) - tools/addon/komodo.sh (port 9120, MongoDB/FerretDB choice) - tools/addon/dokploy.sh (port 3000, external installer) - tools/addon/coolify.sh (port 8000, external installer) - tools/headers/ for all 4 Removed: - ct/dockge.sh, ct/komodo.sh, ct/alpine-komodo.sh, ct/dokploy.sh, ct/coolify.sh - install/dockge-install.sh, install/komodo-install.sh, install/alpine-komodo-install.sh - install/dokploy-install.sh, install/coolify-install.sh - frontend/public/json/ for dockge, komodo, dokploy, coolify - tools/addon/npmplus.sh (not an addon candidate) These tools are Docker-only and fit the addon pattern: they require an existing Docker LXC and manage containers via docker compose. * feat: add addon JSON configs for dockge, komodo, dokploy, coolify Recreate JSON configs with type=addon, script paths pointing to tools/addon/*.sh, null resources (addon runs on existing Docker LXC), and update instructions in notes. * feat: add Runtipi addon + upgrade all addons with Proxmox host check, optional Docker install, Alpine support - New: tools/addon/runtipi.sh with full Alpine support (gcompat for musl) - New: tools/headers/runtipi ASCII header - Updated: runtipi.json to addon type with null resources - Removed: ct/runtipi.sh, install/runtipi-install.sh (migrated to addon) - All addons (dockge, komodo, dokploy, coolify, runtipi) now have: - check_proxmox_host(): warns when running on PVE host, default N - check_or_install_docker(): optional Docker install (Debian+Alpine) - Alpine-aware curl bootstrap and dependency installation * readd ct, update information * Create runtipi.sh * refactor: remove inline header_info from addons, use core.func get_header() - get_header() in core.func now maps APP_TYPE=addon to tools/headers/ path - Removed 5 duplicate ASCII art header_info functions from addon scripts - Addons now use the shared header_info() from core.func + tools/headers/ files * chore(tools): add Github source links to dockge, komodo, dokploy, coolify, runtipi addons * fix(runtipi): drop Alpine support; add OS compat notes to docker addon JSONs
Proxmox VE Helper-Scripts
A Community Legacy in Memory of @tteck
Simplify your Proxmox VE setup with community-driven automation scripts
Originally created by tteck, now maintained and expanded by the community
🎯 Key Features
⚡ Quick SetupOne-command installations for popular services and containers |
⚙️ Flexible ConfigSimple mode for beginners, advanced options for power users |
🔄 Auto UpdatesKeep your installations current with built-in update mechanisms |
🛠️ Easy ManagementPost-install scripts for configuration and troubleshooting |
👥 Community DrivenActively maintained with contributions from users worldwide |
📖 Well DocumentedComprehensive guides and community support |
🔒 SecureRegular security updates and best practices |
⚡ PerformanceOptimized configurations for best performance |
📋 Requirements
🖥️ Proxmox VEVersion: 8.4.x | 9.0.x | 9.1.x |
🐧 Operating SystemDebian-based with Proxmox Tools |
🌐 NetworkInternet connection required |
📥 Getting Started
Choose your preferred installation method:
Method 1: One-Click Web Installer
The fastest way to get started:
- Visit helper-scripts.com 🌐
- Search for your desired script (e.g., "Home Assistant", "Docker")
- Copy the bash command displayed on the script page
- Open your Proxmox Shell and paste the command
- Press Enter and follow the interactive prompts
Method 2: PVEScripts-Local
Install a convenient script manager directly in your Proxmox UI:
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
💬 Join the Community
💬 DiscordReal-time chat, support, and discussions |
💭 DiscussionsFeature requests, Q&A, and ideas |
🐛 IssuesBug reports and issue tracking |
🛠️ Contribute
💻 CodeAdd new scripts or improve existing ones |
📝 DocumentationWrite guides, improve READMEs, translate content |
🧪 TestingTest scripts and report compatibility issues |
💡 IdeasSuggest features or workflow improvements |
👉 Check our Contributing Guidelines to get started
❤️ Support the Project
This project is maintained by volunteers in memory of tteck. Your support helps us maintain infrastructure, improve documentation, and give back to important causes.
🎗️ 30% of all donations go directly to cancer research and hospice care
📈 Project Statistics
📜 License
This project is licensed under the MIT License - feel free to use, modify, and distribute.
Proxmox® is a registered trademark of Proxmox Server Solutions GmbH