Deck will not connect to hexOS

[thault]

The deck shows my hexOS server as unavailable and won't connect. I can see the server is online, shares are up and running, and I can log into the trueNAS web ui directly. 

I did have tailscale on at first, but I have turned that off and tried everything short of restarting hexOS.

[avazquezm]

Hi! Having this same issue since just today, as far as I can tell. Been using HexOS pretty much since a few days after it launched.

Just like others, I can interact with the NAS just fine in any other way, like accessing the TrueNAS Scale interface directly, or accessing an SMB Share, it's just deck.hexos.com seemingly not connecting to it.

Please advise on how to fix it, if a solution has been identified by now. Thanks in advance.

[Mobius]

17 hours ago, celliott113 said:

Having the same issue where this is a fresh install of HexOS, however https://deck.hexos.com/add-new-server/detecting cannot detect the server.

• I can ping the server
• I'm on the same network as the server
• The server has internet access
• The server has been rebooted like 20 times
• mDNS is enabled on HexOS and the UniFi network
• Tried both Brave and Chrome browser standard and incognito

Since it was a fresh install, I figured maybe the version was bad so I changed from v25.04 to v25.10 but to no avail...Idk what else to try other than just managing it from the TrueNAS console directly since I can access the web GUI directly just fine.

Hello,

 

It seems the after the update some systems on reboot are reaching out to our server so it doesn't know your there. Try the following.

 

Login to TrueNAS interface.

Left side select "system".

Then after screen refreshes select "shell" from the list.

Paste in the following command. Can't use normal short cuts Will need to use Shift + Insert Key for pasting.

sudo python /usr/lib/python3/dist-packages/middlewared/scripts/vendor_service.py

 

If that works within about 1 min you should be able to go to deck.hexos.com and see your server or claim it.

[Leroy Dsouza]

I have a similar issue as well. I can access the shared drives, but deck keeps searching and never connects. 

[AbyssalLight]

I hate to be the on to reply only to say "same issue" but If anyone has a solution it'd be greatly appreciated.

[Fieldsend]

I've also got this issue, I don't want to touch anything as it's currently working well otherwise. Would be keen to know if anyone's found a solution.  

[Mobius]

Just confirming your issues are post claiming server with hexos?

[Fieldsend]

23 hours ago, Mobius said:

Just confirming your issues are post claiming server with hexos?

Mine was - claimed some time ago. It now says it's not available but I can still go through TrueNAS.

[Mobius]

Pinging @jonp 

He might have some better insight 

[WVSTEALTH]

Same here, claimed my server in december last year however for since like February/March I've been unable to connect to the server using the hexos dashboard. Server is up and running, I can see it in the network, I can connect to it using truenas interface, I just can't get hexos to connect to it for some reason...

[Mobius]

what parts are in your servers?
is there anything you setup in the truenas interface? (ex. storage pool was made in truenas)

[WVSTEALTH]

20 minutes ago, Mobius said:

what parts are in your servers?
is there anything you setup in the truenas interface? (ex. storage pool was made in truenas)

Fairly basic server setup with a N100 CPU (AOOStar WTR PRO with 4x 4tb HDDs <ST4000DM004-2U9104>)
Really haven't done much in truenas other than debugging an issue I had with plex so it should be mostly the same as hexOs set it up originally.

[Sonic]

Several other users have also a WTR Pro (Intel and AMD version) and are able to run HexOs without any issue. So the hardware is not the problem.

Did you run by any change a TrueNas update?

[WVSTEALTH]

I'm still on 24.10.2. According to Truenas I currently have 2 boot environments, 24.10.2 which was created 23/03/2025 and 24.10.0 which was created in 19/12/2024. Guessing that was when it was updated but can't say for sure if it was me or hexos doing it.

[Sonic]

There was no TrueNas update via HexOs yet. I suspect that you did run the TrueNas update via TrueNas. I think this the reason that you are unable to Connect to the HexOs deck.

[Fieldsend]

I'm still on version TrueNAS-SCALE-24.10.0.

[BlackBetty0206]

I have this issue, I'm on version 25.04.0, so that's likely my issue.

 

[Bulbous_assassin]

I'm afraid I just started to get the same issue, connecting via truenas interface works and I'm running  on version 24.10.0.

System is running as a ZFS 2 with mirrored boot ssd all set up from truenas interface, however I've been connecting fine via the command deck for days without issue since any changes have been made.

[smib]

Add another to the pile.

I have not had to log into the deck for quite a while, but found it unable to connect today. Shares, Plex, and TrueNAS ui are working fine, TrueNAS is version 24.10.0.

[Mobius]

@mill3000 can you take a look into this

[smib]

I tried again just now and was able to connect.

[ETrain]

This may or may not help at all, but I had issues with connting to my server until I went into my router and reserved the IP that my server is using,  If youdl did not do this right away and your router decided to give you a new IP then well your gonna have to set it up as a new server unless you know the IP you first used and manually assign it back to that server under the TrueNAS side.  I also had an issue with network bridging when setting it up on the hexos side it will give out a new IP even if you have your router setup to only use a certain IP,  so again you will have to go into the truenas side and manually assign the correct IP to that bridge, hopefully this will help someone,  idk ¯\_(ツ)_/¯  it might be something else all together but I'm kinda shooting in the wind with what little info that was provided.

[reddragoonmx]

I think I have the same issue. I think I made a mistake with this software I will do a fresh install of truenas without hexOS to see if that fixes my issue. I can't even ping my router. I guess the word Beta means no support in these circles.

[milestechtips]

I seem to have the same issue, currently on TrueNAS-24.10.2.1. Haven't made any changes since it was last working except updates to truenas

[andvasilc]

Same problem over here. Updated to ElectricEel-24.10.2.2 quite a while ago, everything worked just fine. Today tried opening the command deck - server is not available. Although I can still access server through the True NAS. Double-checked that the local IP address has not changed.

[Mascot]

I've been getting the occasional "server unavailable" for a long time. Probably a lot more often than I realize, since I use the HexOS interface so rarely. Whatever functionality is there to detect a lost connection and reconnect, seems to be rather lacking. With no ability to restart just the HexOS layer, the only solution I've found is to restart the whole server. That has always fixed it so far.