Proxmox CasaOS Deploy is an open-source Bash script that transforms a fresh Proxmox LXC container into a fully configured Home Media Server. It installs system dependencies, deploys CasaOS via the official installer, scaffolds media directories for Jellyfin and Plex, and verifies service health — all from a single command run as root.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/damianiglesias/proxmox-casaos-deploy/llms.txt
Use this file to discover all available pages before exploring further.
Quickstart
Run the script and have CasaOS up in under five minutes.
Prerequisites
Check what you need before running the script.
Installation
Step-by-step walkthrough of the deployment script.
Maintenance Mode
Reset passwords and check service status on existing installs.
What the script does
Updates system packages
Runs
apt-get update and installs essential tools: curl, wget, git, htop, and neofetch.Creates media directories
Scaffolds
/DATA/Media/Movies, /DATA/Media/TV_Shows, and /DATA/Downloads with open permissions to avoid Docker volume issues.Key features
Single-command deploy
One script handles everything from package installation to service verification.
Maintenance mode
If CasaOS is already installed, the script switches to an admin menu for password resets and status checks.
Media-ready layout
Automatically creates a
/DATA/Media hierarchy compatible with Jellyfin and Plex Docker containers.Persistent logging
All output is tee’d to
/var/log/casaos_deploy.log for post-install auditing.The script must be run as root inside a Proxmox LXC container running Debian or Ubuntu.