On this page
Remote access: Problems
Find what is wrong with Remote access from what its tab or its card says, then follow the numbered answer. Addresses away from home, on its tab, says the same with more detail.
The chart in words
Start: Remote access is not working as it should
- Then: What does its tab say?
- Failed or Not answering: 1. Start it again
- Not supported: 2. Update it or update Starboard
- Active, but the card is wrong: What does the card say?
- Needs setting up: 3. Choose a way to connect
- Needs signing in or approving: 4. Sign in to Tailscale
- Not connected: 5. Read why it is not connected
- Stopped the tunnel to keep your apps safe: 6. Fix the routes in Cloudflare
- Connected, but an address will not open: 7. Test each address
1 Start it again
- On Remote access's tab, read the message under its state: it says why it stopped.
- Select Try again.
- If it stopped soon after an update, select Roll back to and the version you had. Read Updates.
- Still failing: go to System, then Logs, and find its name.
2 Update it or update Starboard
Your Starboard's plug-in API is outside what this version of Remote access works with, so Starboard stopped it.
- Select Check for an update on its tab.
- If there is none, update Starboard. Read Update Starboard.
3 Choose a way to connect
The card says "Not set up: choose Tailscale or Cloudflare Tunnel in its settings": Connect with is Nothing yet, so nothing runs.
- Go to Settings, then Plug-ins, then Remote access.
- In Connect with, choose Tailscale (recommended) or Cloudflare Tunnel.
- Follow the steps in Install for the way you chose.
4 Sign in to Tailscale
- Needs signing in: the card says "Open the sign-in link on any device and sign in to Tailscale". Open Sign-in link for Tailscale in Addresses away from home, sign in to your own Tailscale account and approve this computer. Remote access carries on by itself.
- Needs approving: the card says "Approve this device in Tailscale's admin page, Machines". Approve it there, and Remote access carries on by itself.
5 Read why it is not connected
The card says Not connected and why. Do what it says:
- "Paste a Tailscale auth key" or "Paste your Cloudflare Tunnel token": the key or token is empty. Paste it, or for Tailscale choose A sign-in link in Sign in with.
- "That is not a Tailscale auth key": auth keys start with
tskey-auth-. Make one in Tailscale's admin page, Settings, Keys, and paste it whole. - "That is not a Cloudflare Tunnel token": copy the long token after
--tokenfrom Cloudflare's dashboard, Networks, Tunnels. - "Tailscale did not accept the auth key": it may be expired, used already or deleted. Make a new one and paste it.
- "Cloudflare did not accept the tunnel token": the tunnel may have been deleted or its token changed. Copy the token again.
- "could not be reached": check the server's internet connection. Remote access tries again by itself.
When you paste a new key or token and select Save, it starts again by itself.
6 Fix the routes in Cloudflare
The card says "Stopped the tunnel to keep your apps safe" and names a route. Remote access reads the tunnel's routes and stops it when one is not safe.
- In Cloudflare's dashboard, find the route the card names.
- Point it at
http://localhost:8095,8096or13378, or delete it. If it leads to an app you have not shared, share the app or delete the route. - If it leads to Starboard, protect it with a Cloudflare Access application, and tick Protect with Access on the route.
- In Starboard, select Start remote access again in Remote access's Actions.
7 Test each address
- Go to Settings, then Plug-ins, then Remote access.
- In Addresses away from home, select Test all.
- Read what it says for each app:
- "is not in Starboard's apps, so it is not shared": add the app in Starboard's apps first.
- "did not answer": the app is not running, or has moved. Check it in Starboard's apps.
- "does not answer to the name": add the name to
STARBOARD_ALLOWED_HOSTSin Starboard's settings file. - "No route in Cloudflare leads to" an app: add a public hostname for it in Cloudflare. - With Tailscale, check your phone is signed in to the same tailnet.
Report a problem
If none of these helps, tell its maker, with what its tab, the card and Addresses away from home say: the plug-ins' issues on GitHub.
Find out more
This page on GitHub, where the help is written.