| name | ha-smb-deploy |
| description | Deploy a Home Assistant custom integration from Linux/WSL2 to a Home Assistant SMB share using CIFS mount, with automatic backup and rsync sync. Use this when user wants safe repeated deployment to /config/custom_components over SMB. |
HA SMB Deploy (Linux)
Use this skill to deploy an integration from a local repo into Home Assistant via SMB on Linux/WSL2.
When to use
- User is on Linux or WSL2
- Home Assistant config is reachable as SMB share (for example
//homeassistant/config)
- User wants repeatable deploy with backup before overwrite
Files in this skill
- Script:
scripts/deploy_ha_smb.sh
Quick usage
If share is already mounted in /tmp/homeassistant_config:
bash skills/ha-smb-deploy/scripts/deploy_ha_smb.sh \
--component energy_control_pro \
--source-root ./custom_components \
--assume-mounted
If share is not mounted yet:
bash skills/ha-smb-deploy/scripts/deploy_ha_smb.sh \
--component energy_control_pro \
--source-root ./custom_components \
--share //homeassistant/config
Behavior
- Validates required tools (
mount, rsync, cp).
- Uses existing mount if present; otherwise mounts SMB share in mountpoint.
- Creates timestamped backup of existing target component if present.
- Syncs source component to
/config/custom_components/<component> with CIFS-safe rsync --delete --inplace and excludes __pycache__/*.pyc.
- Leaves share mounted (faster repeated deploys). Optional unmount flag available.
Notes
- Default mountpoint is
/tmp/homeassistant_config.
- Use
--assume-mounted when you already mounted SMB manually and want zero sudo operations from the script.
- By default, mount mode is guest. For authenticated shares, pass
--username and --password.
- For Home Assistant OS shares, SMB add-on must be configured and reachable from Linux host.
- After deploy, restart Home Assistant or reload the integration as needed.
