Many people love smart home tools. Home Assistant is one of the best tools for this because it gives you full control of lights, fans, locks, and many other things in your house. You can do even more when you add your Elgato Stream Deck to the setup. The Stream Deck is a small board with buttons that you can press to do quick tasks. When you combine the two, you get fast control of your smart home with one touch.
In this guide, you will learn how to set up Home Assistant on Stream Deck. The steps are easy enough for new users, and the tips help you avoid common mistakes.
What you need before you start
Before you set up anything, you should make sure you have a few things ready. Home Assistant should already be running on your device. It can run on a small computer, a server, or any machine that can keep the app open each day. You should also have a Stream Deck connected to your computer. It can be a basic one or a bigger one. All of them work fine for this task.
Your computer must have the Stream Deck app installed. This is the main app that lets you add buttons and change the layout. Once you can see your Stream Deck inside the app, you are ready to move to the next part.
How To Setup Home Assistant on the Elgato Stream Deck
How to install the required plugin
The Stream Deck does not connect to Home Assistant by default. You need a plugin that acts as a bridge between the two.
Start by opening the Stream Deck app. On the right side, click the store icon to open the plugin marketplace. Once it loads, search for Home Assistant. You will see a plugin designed specifically for this purpose. Click install. This adds new Home Assistant actions to your Stream Deck.
At this point, the plugin is installed, but it is not yet connected to your Home Assistant system. You still need to link the two.
How to connect Stream Deck to Home Assistant
Home Assistant uses long lived access tokens to allow external apps to send commands securely. Think of this token as a key that gives the Stream Deck permission to control your smart home.
Open Home Assistant in your browser and click your profile picture in the bottom left corner. Scroll down to the section labeled long lived access tokens. Create a new token and copy it immediately. You will not be able to view it again, so make sure it is saved somewhere safe.
Next, return to the Stream Deck app. Drag a Home Assistant action onto any button. In the settings panel on the right, you will see fields for your Home Assistant address and the access token. Paste the token into the token field and enter your Home Assistant URL. This will usually look like:
If a test button is available, use it to confirm the connection. If everything is set up correctly, the plugin will successfully connect to Home Assistant.
Final thoughts
Once set up, Home Assistant on a Stream Deck gives you fast, reliable, and satisfying control over your smart home. You can trigger automations, control devices, and check states instantly with a single press. It saves time and feels great to use throughout the day.
This setup effectively turns your desk into a compact smart home control center. Many users find themselves relying on it far more often than expected because it is so quick and convenient. As your smart home grows, you can keep adding buttons and actions to match your needs. It is a flexible setup that scales well and fits into almost any Home Assistant environment.
Frequently Asked Questions
Can I use any Stream Deck model with Home Assistant?
Yes, you can use any Stream Deck model. The setup works the same for the small board and the bigger ones. You only need the Stream Deck app and the Home Assistant plugin.
Do I need to install a plugin to make the buttons work?
Yes, you need the Home Assistant plugin from the Stream Deck store. This plugin lets the buttons send commands to your Home Assistant.
How do I get the token for the plugin?
You can make a long lived access token inside your Home Assistant profile page. Copy it once it shows and paste it inside the Stream Deck app when the plugin asks for it.
Why are my buttons not working after setup?
Many times the problem comes from the wrong entity id, a wrong Home Assistant address, or a token that was not entered the right way. Check these three things first.
Can I show light status or other states on the buttons?
Yes, many actions inside the plugin can show the state of lights, fans, or other smart items. This helps you check your home with one quick look.
