[TODO] Proxmox install script for standalone

[Nerivec]

@MickLesk I'm not well-versed in proxmox at all, but figured an install scripts for WindFront standalone might be worth being investigated.
The very "base" should look something like this as far as I can tell:

#!/usr/bin/env bash

source /dev/stdin <<<"$FUNCTIONS_FILE_PATH"
color
verb_ip6
catch_errors
setting_up_container
network_check
update_os

msg_info "Installing Dependencies"
$STD apt-get install -y nginx
msg_ok "Installed Dependencies"

NODE_VERSION="22" setup_nodejs

fetch_and_deploy_gh_release "WindFront" "Nerivec/zigbee2mqtt-windfront" "tarball" "latest" "/opt/zigbee2mqtt-windfront"

read -rp "Enter the Zigbee2MQTT API URLs (comma-separated): " VITE_Z2M_API_URLS
read -rp "Enter the names for the previous URLs (comma-separated, same order): " VITE_Z2M_API_NAMES

msg_info "Building WindFront"
cd /opt/zigbee2mqtt-windfront
$STD npm ci
$STD NODE_ENV=production VITE_Z2M_API_URLS="$VITE_Z2M_API_URLS" VITE_Z2M_API_NAMES="$VITE_Z2M_API_NAMES" npm run build
msg_ok "Built WindFront"

msg_info "Configure Nginx"
rm -rf /usr/share/nginx/html
ln -s /opt/zigbee2mqtt-windfront/dist /usr/share/nginx/html
systemctl restart nginx
msg_ok "Configured Nginx"

motd_ssh
customize

msg_info "Cleaning up"
$STD apt-get -y autoremove
$STD apt-get -y autoclean
msg_ok "Cleaned"

I however don't know how variables should be passed to the script by the user properly (I assume this is possible?):
VITE_Z2M_API_URLS=<var1> VITE_Z2M_API_NAMES=<var2>
And the script probably needs a few fixes. I cannot test any of this 😬
Might also be better with alpine instead, lighter.

Let me know what you think.
Feel free to take it, modify it, publish it... 😉

---

By the way, I was glancing at community-scripts/ProxmoxVE#410 This does not appear to support the new Onboarding feature introduced a while back (would have to remove the .yaml copy from the install script and let Z2M create the default then show onboarding). Is that on purpose (not desired)?

[MickLesk]

This is not an big topic in itself, but why should it be standalone? Isn't the z2m script that you customize in the frontend area enough?

For Special Things we use the read -rp command, to set values with sed

---

What do you mean with onboarding?

[Nerivec]

Standalone WindFront allows users to connect a single frontend instance to multiple Z2M instances (with a switch in the UI to quickly swap). It runs completely independently from Z2M.
It also allows better customization for more advanced use cases since it's just an nginx server with the built frontend files served through it.

---

Built-in interface that detects serial, mDNS, and allow setting the basic configs. It also automatically creates a default configuration.yaml file on first startup. https://www.zigbee2mqtt.io/guide/getting-started/#onboarding
re PR: Koenkk/zigbee2mqtt#26608

[Nerivec]

@KoalaWerewolf I believe you are using a Proxmox setup with standalone WindFront.
Let me know if you would be able to test this out. I'm not sure how what MickLesk said ties to the running of the script (to set the variables, I'm really not familiar with proxmox), but we can at least test that the script itself works by just setting your own variables directly in the script (replace <var1> and <var2>).

[MickLesk]

oh i forgot this thread ^^ can you push it here? https://github.com/community-scripts/ProxmoxVE/discussions/new?category=request-script

[Nerivec]

Should we figure out the details first maybe?
If setting variables is too complicated, it might be a problem, since it depends on these to properly do the install.

[MickLesk]

read -rp before, example:

fetch_and_deploy_gh_release "WindFront" "Nerivec/zigbee2mqtt-windfront" "tarball" "latest" "/opt/zigbee2mqtt-windfront"

read -rp "Enter the Z2M API URLs (comma-separated): " VITE_Z2M_API_URLS
read -rp "Enter the Z2M API names (comma-separated, same order): " VITE_Z2M_API_NAMES

msg_info "Building WindFront"
cd /opt/zigbee2mqtt-windfront
$STD npm ci
$STD NODE_ENV=production VITE_Z2M_API_URLS="$VITE_Z2M_API_URLS" VITE_Z2M_API_NAMES="$VITE_Z2M_API_NAMES" npm run build
msg_ok "Built WindFront"

[Nerivec]

Simple enough!
I missed the fact the link was a discussion, I read push and thought PR 😅

[KoalaWerewolf]

I can try to check tomorrow. Den 31 juli 2025 kl 14:50, Nerivec ***@***.***(mailto:Den 31 juli 2025 kl 14:50, Nerivec <<a href=)> skrev:

…

Simple enough! I missed the fact the link was a discussion, I read push and thought PR 😅 — Reply to this email directly, [view it on GitHub](#107 (reply in thread)), or [unsubscribe](https://github.com/notifications/unsubscribe-auth/ATVVQIN45GRZ5GVZ7DK22WT3LIGJPAVCNFSM6AAAAACA4HWVVKVHI2DSMVQWIX3LMV43URDJONRXK43TNFXW4Q3PNVWWK3TUHMYTGOJUG4YTMNA). You are receiving this because you were mentioned.Message ID: ***@***.***>

[Nerivec]

Let's move to community-scripts/ProxmoxVE#6435