"Device is Empty" — Fix Guide
If your Astrion Remote displays "Device is Empty" or "View is Empty," don't worry — this does not mean the remote is defective. In almost every case, it means Astrion has successfully connected to Home Assistant, but there is no dashboard available to display.
Before You Begin — Avoid Confusing or Blank Names
To prevent synchronization issues and simplify troubleshooting, we strongly recommend avoiding the following for dashboards or views:
Blank names are a common cause of "Device is Empty." A view with no name cannot be identified by Astrion and will not sync. Always give your dashboard and views a unique, descriptive name.
Use unique, descriptive names such as:
💡 Why this matters: "Home" and "Default" already have special meanings inside Home Assistant. Blank names provide no identifier at all. Unique names make troubleshooting much easier.
Why Does This Happen?
Astrion Remote does not create its own interface. Instead, it displays the dashboard you build in Home Assistant using RosCard.
Think of Astrion as a dedicated Home Assistant controller:
If there is no dashboard, no View, no RosCard cards, or invalid entities in the View, Astrion has nothing to display — and shows "Device is Empty".
💡 Good News: This is almost always a configuration issue, not a hardware issue. Your Astrion Remote is working correctly — it just needs something to display.
Step 1 — Confirm Astrion Firmware
On your Astrion Remote, go to Settings → About. Please note:
- Hardware Version
- Firmware Version
For the latest firmware, see the Firmware Updates Guide.
Step 2 — Confirm RosCard Version
Please also confirm your RosCard version. Older RosCard versions may not support newer firmware.
- Check your RosCard version in HACS → Frontend
- If you're running an older version, update via HACS
Step 3 — Confirm the Home Assistant User
This is the most common cause.
Astrion uses the Home Assistant account associated with the Long-Lived Access Token.
Correct Setup
Incorrect Setup
⚠️ Important: Always verify:
- ✅ Dashboard created by the same user
- ✅ View created by the same user
- ✅ Long-lived token belongs to the same user
- ✅ Astrion logs in using that same user
Step 4 — Check Your Dashboard
Open Home Assistant. Navigate to Settings → Dashboards. Confirm your dashboard exists.
💡 Tip: Use a unique name like Astrion,
Living Room, or Lounge to avoid confusion with
Home Assistant's built-in dashboards.
Step 5 — Check the View
Open the dashboard. Verify it contains at least one View.
If there are no Views, Astrion cannot display anything.
⚠️ Check View Visibility
Even if a View exists, it may be hidden in Home Assistant. This is a common oversight that can cause the "Device is Empty" error.
- In your Dashboard settings, check the Visibility setting for each View
- If a View is set to "Hidden", Astrion will not be able to access it
- Make sure the View is "Visible" for the user Astrion is logged in as
⚠️ Important: A View that is hidden in Home Assistant will not appear on Astrion, even if everything else is configured correctly. Always verify that your View is set to Visible.
⚠️ Step 5.1 — Check the View Name (Blank or Conflicting Names)
This is one of the most common causes of "Device is Empty" that is often overlooked. If your dashboard view has a blank name, or uses a name that conflicts with Home Assistant's built-in views, Astrion may not be able to sync it.
What Counts as an Invalid View Name
- Blank / empty name — The view has no name at all (most common issue)
- "Home" — Conflicts with Home Assistant's default view name
- "Default" — Reserved by Home Assistant and may not sync
- "Overview" — Also used by Home Assistant internally
⚠️ Critical: A view with a blank name will not sync to Astrion, even if it contains valid RosCards. This is because Astrion identifies views by name, and a blank name provides no identifier.
How to Fix a Blank or Invalid View Name
- Open your Home Assistant dashboard in a browser.
- Click Edit Dashboard (pencil icon, top right).
- Find the view tab you want to use with Astrion.
- Click the pencil icon next to the view tab to open view settings.
- Enter a unique, descriptive name in the Title field.
- Save and exit edit mode.
- On your Astrion Remote, pull down to Refresh.
Recommended View Names
✅ Real-world example: A customer reported that their dashboard view had no name. After giving it a name (e.g., "Living Room"), the Astrion Remote immediately displayed all cards correctly. Naming the view was the only change needed.
Quick Checklist for View Configuration
- ✅ Dashboard has a unique name (not "Home", "Default", or blank)
- ✅ View has a non-blank name
- ✅ View is set to Visible (not hidden)
- ✅ View contains at least one RosCard
- ✅ RosCard has at least one valid, available entity
- ✅ Same Home Assistant user created the dashboard, view, RosCard, and token
Step 6 — Add a RosCard
Inside the View:
- Click Add Card
- Select a RosCard type
- Configure your entities
For more details, see the RosCard Guide.
⚠️ Common Mistake — Empty Cards
A View may have a RosCard added, but the card itself contains no entities. This can also cause the "Device is Empty" error.
- Open each RosCard in your View
- Verify that at least one entity is assigned to the card
- If a card has no entities, remove it or add entities to it
⚠️ Important: A RosCard with no entities is effectively empty. Astrion will not display anything for that card, and if all cards are empty, the View will appear empty.
Step 6.1 — Check Entity Validity
Even if a RosCard has entities assigned, those entities may be invalid or unavailable in Home Assistant.
- In Home Assistant, go to Developer Tools → States
- Search for the entity ID used in your RosCard
- If the entity is "unavailable" or "unknown", it cannot be displayed
- If the entity does not exist at all, the card will fail to load
Common Entity Issues
- Typo in entity_id: Check for spelling errors
- Entity renamed: The device may have been renamed in Home Assistant
- Integration removed: The device or integration may no longer be available
- Device offline: The entity may be unavailable because the device is not connected
⚠️ Important: A RosCard with invalid or unavailable entities will not display correctly. Always verify that your entities are valid and available in Home Assistant before troubleshooting Astrion.
Step 7 — Test in Home Assistant
Before using Astrion:
- Log into Home Assistant using the same user
- Can you see the dashboard?
- Can you see the RosCard?
⚠️ Important: If Home Assistant cannot display it, Astrion cannot either.
Step 8 — Verify Astrion Connection
On your Astrion Remote, go to Settings → Home Assistant. Confirm:
- ✅ Connected
- ✅ Correct IP address
- ✅ Correct Port
Common Mistakes
- ❌ Dashboard created under User A, but Astrion logs in using User B
- ❌ Dashboard has no Views
- ❌ View contains no RosCard
- ❌ View name is blank (no name at all)
- ❌ RosCard has no entities assigned
- ❌ RosCard contains invalid or unavailable entities
- ❌ View is set to "Hidden" in Home Assistant
- ❌ Dashboard named "Home"
- ❌ View named "Default"
- ❌ Dashboard named "Main"
- ❌ Old RosCard version
- ❌ Incorrect Home Assistant IP address
✅ Quick Fix: If you can assign entities to the Astrion's physical buttons, but the dashboard still says "Device is Empty," this means your connection to Home Assistant is working. The issue is almost always dashboard configuration, Views, user permissions, or entity validity — not the remote itself.
Still Seeing "Device is Empty"?
If you've followed all the steps above and the issue persists, please send us:
- Screenshot of Astrion → Settings → About
- Firmware Version
- Hardware Version
- RosCard Version
- Screenshot of your Dashboard
- Screenshot of your View (including the view title)
- Screenshot of your RosCard
- Screenshot of Home Assistant Users
- Screenshot of Astrion Home Assistant Settings
Our support team will be happy to help.
Related resources
Still having issues?
Our support team and community are here to help.