ha-pass lets you give guests limited control over your Home Assistant devices. You do not need to share your Home Assistant account or have your guests install any app. Instead, ha-pass creates a simple mobile-friendly web app your guests open from a link.
You can choose exactly which devices or sensors the guest can see or control. You set a time limit to how long the guest can use the link. After this time, the link stops working.
This makes it safe and easy to share smart home control with visitors.
- Scoped guest tokens: Control which devices or sensors guests can access.
- Time-limited access: Set how long the guest can use the link before it expires.
- Live updates: Guest screens show real-time changes in device status.
- Mobile-friendly PWA: Guests open the link in any browser or install it as an app shortcut.
- No need for guest accounts or app installs.
- A Windows PC or laptop running Windows 10 or later.
- Internet connection to access Home Assistant and ha-pass links.
- A modern web browser (Chrome, Edge, Firefox, or similar) for guests.
- Home Assistant set up with access to your smart home devices.
You will download the software and run it on your Windows computer. Follow these steps carefully.
Step 1: Open the download page
Click the large green button below to open the ha-pass repository on GitHub. You will find all files needed to run the app there.
Step 2: Download the latest release
On the GitHub page, look for a link or section called "Releases". This section contains the setup files you need.
- Click on "Releases" in the right menu or near the top.
- Find the latest release. Usually, it will be at the top.
- Download the Windows setup file. It often ends with
.exe.
Step 3: Run the installer
- Locate the downloaded file in your "Downloads" folder.
- Double-click the file to start the installation.
- Follow the instructions on the screen to complete setup.
Step 4: Open ha-pass
- After installation, launch ha-pass from your Start menu or desktop.
- The program will open an admin dashboard in your default browser.
- You can now start creating guest access tokens and control who sees what.
- Open ha-pass on your computer.
- Use the dashboard to choose which devices you want to share.
- Set the length of time the guest can access these devices.
- Generate a token. The app will provide you a link.
- Send the link to your guest by email, text, or message.
- Your guest opens the link in their phone browser to control devices.
- Guests open the link you send in any mobile browser.
- The page loads a simple control interface.
- Guests can turn devices on or off or check status as you allow.
- The page updates immediately if device states change.
- Guest access ends automatically after the set time.
- Choose only the devices you want guests to control.
- Do not share links publicly. Only send them to trusted guests.
- Regularly clear expired tokens from the admin dashboard.
- Use ha-pass on a PC close to your Home Assistant server for best performance.
- Guests do not need to create login accounts or install apps to use ha-pass.
- Visit the GitHub page for user guides and troubleshooting tips.
- Check the "docs" folder on GitHub for detailed screenshots and feature explanations.
- Monitor your Home Assistant logs if devices don't update as expected.
- Use modern browsers for best experience with the PWA features.
Access the latest version here:
Click the badge to visit the page and download the software files.
Follow the steps above to install and start using ha-pass securely with your smart home.