Remote access

Version 1.1.3 · plug-in API >=1.14 <2.0

PublishedHow to add it
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.

Find your answer
Flow chart: Remote access is not working as it should. The same chart is written out in words after it.Failed or Not answeringNot supportedActive, but the card iswrongNeeds setting upNeeds signing in orapprovingNot connectedStopped the tunnel tokeep your apps safeConnected, but anaddress will not openRemote access is notworking as it shouldWhat does its tabsay?What does the cardsay?Start it again1Update it or updateStarboard2Choose a way toconnect3Sign in to Tailscale4Read why it is notconnected5Fix the routes inCloudflare6Test each address7
The chart in words

Start: Remote access is not working as it should

1 Start it again

  1. On Remote access's tab, read the message under its state: it says why it stopped.
  2. Select Try again.
  3. If it stopped soon after an update, select Roll back to and the version you had. Read Updates.
  4. 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.

  1. Select Check for an update on its tab.
  2. 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.

  1. Go to Settings, then Plug-ins, then Remote access.
  2. In Connect with, choose Tailscale (recommended) or Cloudflare Tunnel.
  3. 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 --token from 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.

  1. In Cloudflare's dashboard, find the route the card names.
  2. Point it at http://localhost:8095, 8096 or 13378, or delete it. If it leads to an app you have not shared, share the app or delete the route.
  3. If it leads to Starboard, protect it with a Cloudflare Access application, and tick Protect with Access on the route.
  4. In Starboard, select Start remote access again in Remote access's Actions.

7 Test each address

  1. Go to Settings, then Plug-ins, then Remote access.
  2. In Addresses away from home, select Test all.
  3. 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_HOSTS in Starboard's settings file. - "No route in Cloudflare leads to" an app: add a public hostname for it in Cloudflare.
  4. 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.