Files
ProxmoxVE/docs/guides/README.md

2.4 KiB

Configuration & Deployment Guides

This directory contains comprehensive guides for configuring and deploying Proxmox VE containers using community-scripts.

📚 Available Guides

Configuration Reference

Complete reference for all configuration options, environment variables, and advanced settings available in the build system.

Topics covered:

  • Container specifications (CPU, RAM, Disk)
  • Network configuration (IPv4/IPv6, VLAN, MTU)
  • Storage selection and management
  • Privilege modes and features
  • OS selection and versions

Defaults System Guide

Understanding and customizing default settings for container deployments.

Topics covered:

  • Default system settings
  • Per-script overrides
  • Custom defaults configuration
  • Environment variable precedence

Unattended Deployments

Automating container deployments without user interaction.

Topics covered:

  • Environment variable configuration
  • Batch deployments
  • CI/CD integration
  • Scripted installations
  • Pre-configured templates

Core Runtime Sourcing Guide

How local-first loading, remote fallback, and ref/base pinning work for core runtime modules.

Topics covered:

  • Local-first module resolution (misc/*.func)
  • Branch/tag/commit pinning with COMMUNITY_SCRIPTS_REF
  • Custom remote base URLs (COMMUNITY_SCRIPTS_REMOTE_BASE, COMMUNITY_SCRIPTS_INSTALL_BASE, COMMUNITY_SCRIPTS_CT_BASE)
  • CT update behavior (/usr/bin/update source resolution)
  • Production hardening and troubleshooting

💡 Quick Start

For most users, start with the Unattended Deployments guide to learn how to automate your container setups.

For advanced configuration options, refer to the Configuration Reference.

For runtime source hardening and pinning, read the Core Runtime Sourcing Guide.

🤝 Contributing

If you'd like to improve these guides or add new ones, please see our Contribution Guide.