Home Assistant Windows Portable (HassWP)

Portable version of Home Assistant for Windows.

ATTENTION: Direct works on Windows is not maintained by the core developers of Home Assistant. So some components/integrations may not work at all. No need to ask me or the core authors to fix it. If something you need doesn't work - use virtualization.

Preinstalled:

• WinPython v3.14.7 64-bit
• Home Assistant v2026.10.4
• NotePad++ v7.8.5 32bit
• HACS v2.0.5

HOWTO

1. Download HassWP_XXXX.XX.X.zip
2. Unpack
3. Run

Useful files:

• hass.cmd - run Home Assistant and default Browser
• notepad.cmd - run NotePad with configuration.yaml
• web.url - open default Browser with http://localhost:8123/
• config/reset.cmd - reset Home Assistant but don't touch config files

Supervisor and Addons

HassWP don't have and can't have supervisor and any Hass.io addons. Supervisor can be installed only over Docker. Nativelly Docker works only on Linux core. In any other OS it will use virtualization.

If you really needs Hass.io addons on Windows - use virtualization.

Move config

You can transfer your configuration to another Hass installation at any time. In another HassWP, venv, docker, hass.io, etc. Windows or Linux, it doesn't matter. Just move the contents of the config folder to a new location. Remember about config/.storage folder, it is also important.

Before any movement - stop the old and new Home Assistant!

Video Demo

Windows ARM64

Starting with versions released in 2026, the hass_win supports running Home Assistant on Python arm64. The missing part of the libraries is being compiled in a separate project - python-wheels. The portable version is not being built because there is no WinPython for arm64.

Do it yourself

1. Download and unpack WinpythonXX-3.XX.XX.0dot.exe
2. Run from command line:

scripts\env.bat
pip install uv
uv pip install homeassistant==XXXX.XX --system
uv pip install https://github.com/AlexxIT/HassWP/archive/master.zip --system
mkdir config
python -m hass_win -c config -v