Pair Your Astrion Remote with Home Assistant
Complete your Astrion Remote setup by pairing it with Home Assistant. Generate an access token, scan a QR code, and start controlling your smart home.
Prerequisites
Before you begin, make sure you have the following:
- Home Assistant running (Core 2023.1 or newer)
- HACS (Home Assistant Community Store) installed
- Astrion Remote powered on and connected to Wi-Fi
- Both devices on the same local network
📌 Important: Astrion Remote is a control terminal, not a device to be integrated. It will not appear in your Home Assistant integrations list — it communicates via the WebSocket API.
Step-by-Step Pairing Guide
1 Install RosCard via HACS
RosCard is the custom card package that optimizes the Home Assistant dashboard for Astrion's 3.1-inch display.
- Open Home Assistant → HACS → click ⋮ (menu) → Custom repositories
- Add: Repository URL:
https://github.com/yyqclhy/RosCard| Category:Dashboard - Refresh HACS (press F5), search for RosCard, click Download
- Restart Home Assistant if prompted
2 Create a Long-Lived Access Token
In Home Assistant, you need to generate a token that allows the Astrion Remote to authenticate with your server.
- Click your profile icon (bottom-left corner)
- Scroll to Security & Privacy
- Click Long-Lived Access Tokens → Create Token
- Name it "Astrion Remote" and click Create
- Copy the token immediately — you won't be able to see it again
🔒 Security: Keep your access token secure. If compromised, revoke it from the same Security settings page.
3 Generate a QR Code
Create a QR code containing your Home Assistant URL and the access token. This is the recommended method for pairing.
Example:
Use any QR code generator tool (online, HA add-on, or command line) to convert this URL into a QR code.
4 Scan QR Code on Astrion Remote
On your Astrion Remote, navigate to the Home Assistant login screen and scan the QR code.
- Open Settings on your remote
- Select Home Assistant → Login
- Tap "Scan QR Code"
- Point the camera at the QR code you generated
5 Verify Connection
Wait for the connection confirmation. If successful, your Astrion Remote will automatically load your RosCard views.
- You should see your Home Assistant dashboard appear on the remote
- If views don't appear immediately, pull down from the top of the screen and tap the Refresh button
✅ Success! Your Astrion Remote is now paired with Home Assistant. You can start controlling your smart home devices.
Manual Login (Alternative)
If QR code scanning isn't working, you can enter the Home Assistant URL and token manually.
Steps for Manual Setup
- Open Settings → Home Assistant → Login
- Select "Manual Setup" at the bottom of the screen
- Enter your Home Assistant URL:
http://YOUR_HA_IP:8123 - Paste your Long-Lived Access Token
- Tap "Connect"
💡 Tip: If automatic discovery fails, you'll be prompted to enter the HA URL manually. This is common if your router doesn't support mDNS discovery or if devices are on different subnets.
Troubleshooting
QR Code Scan Fails
- Ensure the QR code contains the full URL with the token
- Check that the token hasn't been revoked
- Try using a different QR generator tool
- Try the manual login method as an alternative
Remote Shows "No Connection"
- Verify both devices are on the same Wi-Fi network
- Check that your Home Assistant server is running
- Ensure the HA URL is correct — use the local IP address
- Try restarting the remote and your HA server
Automatic Discovery Fails
- Enter the HA URL manually:
http://YOUR_HA_IP:8123 - Make sure network discovery is enabled in Home Assistant
- Check that your router supports mDNS (Bonjour)
RosCard Views Not Loading
- Pull down from the top of the home screen and tap Refresh
- Verify that RosCard is installed in HACS
- Check that you have at least one RosCard added to your dashboard
- Try restarting the remote
Token Expired or Revoked
- Revoke the old token from Home Assistant
- Create a new Long-Lived Access Token
- Regenerate the QR code with the new token
- Re-scan or re-enter the credentials on the remote
🔒 Security Reminder: If you lose your remote, immediately revoke its access token from Home Assistant to prevent unauthorized access to your smart home.
Setup Complete! 🎉
Congratulations! Your Astrion Remote is now fully set up and paired with Home Assistant. You can now start exploring your RosCard dashboards and controlling your smart home devices.
Where to go from here
- Explore RosCard: Customize your dashboards with Light Cards, Climate Cards, and more
- Configure shortcuts: Map physical buttons to your favorite devices and scenes
- Join the community: Share your setup and get tips from other Astrion users
Related resources
Need help pairing?
Our support team and community are here to assist you.