Ga naar inhoud
↑↓Navigeren ↵Openen escSluiten

Deze inhoud is nog niet vertaald.

Remote Access

When you can’t reach TokenWork from your phone or another machine, the fix depends on how you’re connecting.

Check the basics first

  • open http://localhost:3000 on the same computer first — if that fails, it’s not a remote problem; see OpenCode connection
  • confirm the server is running with openchamber status

Paired device won’t connect

  • the QR code / pairing link is single-use — if it was already scanned (or expired), create a new one from Add a device
  • if the device was paired with Home network only, it can’t connect from outside that network — pair it again with Anywhere
  • for Anywhere pairing, check Settings → Remote Instances → TokenWork Relay on the server: it should say Connected; if not, disable and re-enable it
  • if a device was revoked, its token is gone for good — pair it again with a new QR code

See Connect a Device and Private Relay for how these connections work.

  • run openchamber tunnel status --all
  • restart the tunnel from the same instance and port
  • regenerate the connect link if the previous one was already used

See Tunnels for the full setup.

Remote instance won’t connect (desktop)

When a remote instance stalls, TokenWork names the step that failed:

  • auth — your SSH or UI password was rejected; re-enter it
  • install / start — TokenWork couldn’t set up or start the server on the remote machine; check that machine’s requirements
  • forwarding — the connection is up but the port isn’t reaching you; try a different local port

Behind your own server

If you put TokenWork behind a reverse proxy and it loads oddly or won’t connect, see Reverse Proxy.