# \[TUTORIAL\] Homey SHS on Proxmox Interactive installer **URL:** \ **Category:** Tutorials\ **Tags:** homey-shs\ **Created:** [January 27, 2026, 7:52pm UTC](https://community.homey.app/t/tutorial-homey-shs-on-proxmox-interactive-installer/150170 "2026-01-27T19:52:19Z")\ **Posts on this page:** 6\ **Page:** 1
**Author:** ![Anoniemand](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/anoniemand/32/120697_2.png) [@Anoniemand](https://community.homey.app/u/Anoniemand)\ **Post date:** [January 27, 2026, 7:52pm UTC](https://community.homey.app/t/tutorial-homey-shs-on-proxmox-interactive-installer/150170/1 "2026-01-27T19:52:19Z")
After a question about how to migrate to a Proxmox Homey SHS environment, I have created an interactive installer. With this installer you are able to install Homey SHS on Proxmox with some more flexibility: - You can choose your storage (current Athom installer might refer to storage that doesn’t exist) - Select a VLAN (if bridge is VLAN aware) - Disable auto start of Homey SHS (to migrate data) - Disable auto update (for those who like to be in control of when an update starts) You can view the script before you use it over [here](https://github.com/anoniemnd/homey-shs-toolkit/blob/main/Proxmox_Interactive_Installer/homey-shs-proxmox-interactive.sh). # Homey Self-Hosted Server - Proxmox Interactive Installer An interactive version of the Homey SHS installer for Proxmox VE, featuring a user-friendly wizard interface and additional configuration options. ## Why use the Interactive Installer? The standard Homey SHS installer uses fixed defaults (`local`, `local-lvm`, `vmbr0`). This interactive version offers: - **Storage selection** - Automatically detects available storages instead of assuming `local` and `local-lvm` - **Network bridge selection** - Detects all available bridges instead of assuming `vmbr0` - **VLAN support** - Configure VLAN tags on VLAN-aware bridges - **Auto-update control** - Choose whether to automatically pull the latest Docker image on restart - **Migration support** - Option to skip starting Homey SHS, allowing you to restore userdata first ## Requirements - **Proxmox VE 9.x** (uses Debian 13 template, same as official Homey installer) - Root access to the Proxmox host - Internet connection The following tools are required (included by default on Proxmox): - `whiptail` - For interactive dialogs - `jq` - For JSON parsing If not present: ```bash apt update && apt install -y whiptail jq ``` ## Installation ### Direct execution (recommended) ```bash bash -c "$(curl -fsSL https://raw.githubusercontent.com/anoniemnd/homey-shs-toolkit/refs/heads/main/Proxmox_Interactive_Installer/homey-shs-proxmox-interactive.sh)" ``` ### Manual download ```bash curl -O https://raw.githubusercontent.com/anoniemnd/homey-shs-toolkit/refs/heads/main/Proxmox_Interactive_Installer/homey-shs-proxmox-interactive.sh chmod +x homey-shs-proxmox-interactive.sh ./homey-shs-proxmox-interactive.sh ``` ## Installation Steps The wizard guides you through each configuration option: ### Step 1: Container ID Enter the container ID, default the first available ID. ![interactive_container_id](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/e/4/e40ec8f1134c4171a334f9c0a975d2fcea0e6a99.png) ### Step 2: Hostname Enter the hostname, default homey-shs. ![interactive_hostname](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/f/e/fe4281f751f651129ad4a6fea82b61629680be49.png) ### Step 3: Template Storage Select the storage for the container template > **Note:** This dialog only appears if multiple template storages are configured. Otherwise, the only available storage is selected automatically. (screenshot for reference) ![interactive_template](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/6/7/677f346bbb5c8c914cc9b9831227a8c3d6e932b3.png) ### Step 4: Root Filesystem Storage Select the storage for the container root filesystems. > **Note:** This dialog only appears if multiple root filesystem storages are configured. Otherwise, the only available storage is selected automatically. ![interactive_storage](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/1/3/13e1020bab83260065f824264019503c8ad520ac.png) ### Step 5: Network Bridge Select the network bridge. > **Note:** This dialog only appears if multiple network bridges are configured. Otherwise, the only available storage is selected automatically. (screenshot for reference) ![interactive_bridge](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/1/1/11bb43822ebfd9067c9267199589151e847dc1b7.png) ### Step 6: VLAN Tag (optional) Enter a VLAN if required, otherwise leave blank > **Note:** : Only shown if the selected bridge is VLAN-aware. ![interactive_vlan](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/a/1/a139d50bbdaddcc177fda97de0151f3978229ed8.png) ### Step 7: Resources | Resource | Default | Minimum recommended | | --- | --- | --- | | Disk | 16 GB | 8 GB | | CPU | 2 cores | 1 core | | RAM | 2048 MB | 1024 MB | | Swap | 512 MB | 256 MB | ![interactive_disk_size](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/0/d/0df1e42dafed9e06e243406d497e631e7422370f.png) ![interactive_cpu](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/7/0/7069a4463e77e952350b12e1cffdc7735981701c.png) ![interactive_ram](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/1/8/185ceee3fd0ab67c3916bee9af8599c4305981c1.png) ![interactive_swap](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/b/4/b40b45e077611a72c3ecb98a99b0ba569fd83ff2.png) ### Step 8: Root Password Enter the root password, default: homey ![interactive_password](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/d/b/db7550fdba42706b1e90d94a5c560794f4b0017f.png) ### Step 9: Autostart Homey SHS after installation Choose whether to start Homey SHS immediately after installation: - **Yes** - Normal installation, starts immediately - **No** - For migrations: restore userdata before first start ![interactive_autostart_homey](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/8/0/806f6771696f88c880f4081f31311b11cf7bdb76.png) ### Step 10: Auto Update Homey on restart service / LXC Choose whether to automatically pull the latest Docker image: - **Yes** - Pull latest image on every service restart (Default) - **No** - Only pull if no image exists locally ![interactive_autoupdate_homey](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/2/2/22e8492f365ade5c184be2224d625d30da68e859.png) ### Step 11: Confirmation Review all settings before installation begins. ![interactive_confirm](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/7/1/713753b93039bcffd559d190ca8af79b48443729.png) ## After Installation ![interactive_installed](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/b/b/bb053b1ad4e11e4d333ff1d1b7db73b045b94b2c.png) ### Access | Type | Address | | --- | --- | | Web interface | `http://:4859` | | SSH | `ssh root@` | ### Important paths | Path | Description | | --- | --- | | `/root/.homey-shs/` | Homey userdata | | `/usr/local/bin/homey-shs.sh` | Deploy script | | `/tmp/homey-shs-install-.log` | Installation log | ## Management ```bash # View status pct exec -- systemctl status homey-shs # Restart pct exec -- systemctl restart homey-shs # View logs pct exec -- docker logs homey-shs ``` ### Manual update (when auto-update disabled) ```bash pct exec -- docker pull ghcr.io/athombv/homey-shs pct exec -- systemctl restart homey-shs ``` ## Migration Guide To migrate an existing Homey SHS installation: 1. Run the installer and select **No** at “Autostart Homey SHS” 2. Copy your userdata to the new container (/root/.homey-shs). 3. Start Homey SHS: ```bash pct exec -- systemctl start homey-shs ``` ## Troubleshooting ### Container won’t start ```bash pct status pct start --debug ``` ### No network ```bash pct exec -- ip addr pct exec -- dhclient eth0 ``` ### Homey SHS won’t start ```bash pct exec -- systemctl status homey-shs pct exec -- docker ps -a cat /tmp/homey-shs-install-.log ``` ## License MIT License ---
**Author:** ![Olex](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/olex/32/79016_2.png) [@Olex](https://community.homey.app/u/Olex)\ **Post date:** [January 27, 2026, 10:02pm UTC](https://community.homey.app/t/tutorial-homey-shs-on-proxmox-interactive-installer/150170/2 "2026-01-27T22:02:06Z")
Many thanks, this is impressive! I have a current test setup with Proxmox VE and Backup server, where I try to learn the basic with the packages. I will try your setup when I’m ready for the final transfer from Synology to Proxmox. ---
**Author:** ![Olex](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/olex/32/79016_2.png) [@Olex](https://community.homey.app/u/Olex)\ **Post date:** [January 28, 2026, 6:59am UTC](https://community.homey.app/t/tutorial-homey-shs-on-proxmox-interactive-installer/150170/3 "2026-01-28T06:59:26Z")
> [@Anoniemand](#): > > Run the installer and select **No** at “Autostart Homey SHS” Just one question: if I select NO to “autostart Homey SHS” in order to copy the user data to the new container, will Homey SHS autostart with the the next reboot/s (like from an power outage)? ---
**Author:** ![Anoniemand](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/anoniemand/32/120697_2.png) [@Anoniemand](https://community.homey.app/u/Anoniemand)\ **Post date:** [January 28, 2026, 7:13am UTC](https://community.homey.app/t/tutorial-homey-shs-on-proxmox-interactive-installer/150170/4 "2026-01-28T07:13:38Z")
Yes it will. It will only prevent the direct start after it is installed. You can reboot the Proxmox container or start the service as explained in Migration Guide. > edit: > ✍ : Altered the question in interactive installer and updated the screenshot. > Thanks for the valuable feedback ---
**Author:** ![Olex](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/olex/32/79016_2.png) [@Olex](https://community.homey.app/u/Olex)\ **Post date:** [January 31, 2026, 9:01am UTC](https://community.homey.app/t/tutorial-homey-shs-on-proxmox-interactive-installer/150170/5 "2026-01-31T09:01:37Z")
Again, many thanks! Just tested this and implemented this as my working SHS. Worked as a charm, even my Thread devices which I currently are testing worked immediately. ---
**Author:** ![Anoniemand](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/anoniemand/32/120697_2.png) [@Anoniemand](https://community.homey.app/u/Anoniemand)\ **Post date:** [January 31, 2026, 5:59pm UTC](https://community.homey.app/t/tutorial-homey-shs-on-proxmox-interactive-installer/150170/6 "2026-01-31T17:59:27Z")
No problem. I like to create these kind of things. Good you’ve got SHS running smoothly now on Proxmox.