This guide walks you through every step needed to go from a blank Proxmox host to a fully running CasaOS instance — from creating the LXC container to opening the setup wizard in your browser. If your container is already created and you want a line-by-line breakdown of what the script does, see the detailed installation walkthrough.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.
Create a Proxmox LXC Container
In the Proxmox web interface select Create CT and configure the container with the following minimum specifications:
Before confirming, open the Options tab for the new container and enable Nesting. Nesting allows the container to run Docker — which CasaOS relies on for its entire app store — so this step is required, not optional.
| Setting | Recommended value |
|---|---|
| Template | Debian 12 or Ubuntu 22.04 |
| CPU cores | 2 |
| RAM | 2048 MB (2 GB) |
| Disk | 10 GB |
Access the Container Shell
Start the container, then open a root shell using one of two methods:Proxmox web console — select the container in the left-hand tree, click the Console tab, and log in as The script checks
root.SSH — connect directly from your workstation once the container has an IP address:$EUID at startup and exits immediately if it is not run as root, so make sure you are in a root session before proceeding.Download the Script
Inside the container shell, pull down Alternatively, clone the full repository if you prefer to have the source locally or want to review the script before running it:
casaosscript.sh using wget:Make It Executable and Run It
Grant execute permission and launch the script in a single command:If you cloned the repository, the command is the same — just run it from inside the cloned directory.
Wait for Completion
The script prints coloured progress banners as it works through four stages:The final lines of output confirm the service state and print your container’s LAN address:The exact IP shown will match the address assigned to your container by your local network’s DHCP server.
Open CasaOS in Your Browser
On any device connected to your local network, navigate to the address printed in the final output — for example:CasaOS listens on port 80 by default, so no port number is needed in the URL. The first time you visit the address you will see the CasaOS initial setup wizard, which guides you through creating your admin account and personalising your dashboard before you start installing apps.
For a detailed line-by-line explanation of every command the script runs — including what each dependency does and how the health check works — see the Installation Guide.