Pular para o conteúdo
Esta página está em inglês

O guia é escrito em inglês. O resto do site é traduzido.

Fix a connection that fails

Match the message the app shows to its cause, then follow the steps that fix it.

Connect screen on the Local network tab with a host field and the warning banner.
The connect screen names the failure, so start from the sentence you see.

Almost every fix is on the computer. The phone is the device that reports the problem.

Cannot reach the harness

Two messages belong here. Nothing answered at … means the packets were dropped. … refused the connection means the port has no listener.

  1. Allow port 3080 through the computer's firewall, for the Private and Domain profiles.
  2. Start the harness on its network address with dsh web --host …, then restart it.
  3. Check the router for client isolation, which guest networks turn on.

Connect over Wi-Fi has the whole setup.

The address was refused

The harness refused this address means the harness answered and does not trust the name you used.

  1. Connect with the computer's IP address instead of its name.
  2. Or start the harness with dsh web --trusted-host … and restart it.

A scan lists a harness in this state as Not trusted rather than hiding it.

Wrong network

… isn't on this phone's network. This phone is on … means the two devices are on different subnets, so nothing on the phone can route there.

  1. Join both devices to the same router network. Guest and IoT Wi-Fi are usually kept separate.
  2. Compare the addresses: ipconfig on Windows, ip addr on Linux, ifconfig on macOS.
  3. If a name does not resolve, the app says Nothing on this network answers to “…”. Use the IP address instead.

Something that is not a harness

Something answered at …, but it isn't a DeepSeek Harness. Something else holds that port.

  1. Use the port the harness printed when it started.
  2. Check the port in the app matches it, then try again.

Sign-in failed

… is a harness, but it hasn't signed this phone in. The address is right and the token is missing or stale.

  1. Paste the whole startup link, token included.
  2. If the harness restarted, take the new link: The harness didn't accept that token. It changes on every restart, so check the latest startup line.

Streams closed

… answered, but its event stream wouldn't open. The calls work and the WebSocket does not.

  1. Turn off a VPN or private DNS on the phone, then retry.
  2. Turn off an HTTP proxy, if one is set.
  3. Force-stop the app and open it again.

Relay pairing failed

The relay refused that code. Each code works once and expires after a few minutes. The relay read the code and rejected it.

  1. Reload /relay/pair on the computer and use the new code.
  2. If the app says The relay refused this device, pair again: the token expired or was removed from the device list.
  3. If a scan says Refuses this address, add that address to publicHostnames in the relay's cordis.patch.yml, then restart the relay.

Connect from outside your home network covers pairing.

Verificado com 0.20.0 em 2026-11-09

PróximoQuestions and answers