---
title: "Remote connection states"
url: https://devlanes.run/docs/reference/remote-states/
description: "The states and warnings devlanes remote ls shows for a box, and what to do about each."
updated: 2026-11-16T02:09:32.000Z
---

# Remote connection states

`devlanes remote ls` lists each box this machine knows, with the state of its connection, what it mirrors and any warnings. [Remote mirroring](/docs/concepts/remote-mirroring/) explains the connection.

## States

| State | Meaning | What to do |
|---|---|---|
| `connecting` | Your machine is reaching the box. | Wait. |
| `connected` | The box's lanes are mirrored here. | Nothing. |
| `reconnecting` | The connection dropped, after sleep or a network change, and devlanes tries again on its own. The box's ports and hostnames stay in place meanwhile. | Wait. `error` says why it dropped. |
| `needs_auth` | Reconnecting needs you: SSH asks for a password, a passphrase or a host key. | Run `devlanes remote connect BOX` in a terminal. |
| `needs_pairing` | The box no longer accepts this machine, or no pairing code was given. | Run `devlanes daemon pair` on the box, then `devlanes remote connect BOX --code CODE` here. |
| `failed` | Trying again cannot help, for example the two machines run releases too far apart to talk, or the box turns connections away. `error` says why. | Fix the cause, then run `devlanes remote connect BOX`. |
| `disconnected` | The box is known but not connected, as after `devlanes remote disconnect`. | Run `devlanes remote connect BOX` to connect again. |

A pairing code from `devlanes daemon pair` works once and expires after a few minutes. [Connect to a box](/docs/how-to/remote/connect/) has the steps.

## Warnings

| Warning | What to do |
|---|---|
| <code>the box runs devlanes VERSION and this machine VERSION.<wbr> Install the same release on both.<wbr></code> | Update the machine that is behind ([Update and uninstall](/docs/how-to/update/)). |
| ``the box stops your processes at logout. Run `sudo loginctl enable-linger "$USER"` there.`` | Run that command on the box. |
| ``the box daemon stops when this SSH session ends. Run `devlanes daemon install` on the box`` | Run that command on the box. |
| <code>port PORT is not mirrored because .<wbr>.<wbr>.<wbr></code> | Something on this machine already uses the port, as the message names. Stop it, or keep the service on the box ([Choose what a box shares](/docs/how-to/remote/what-a-box-shares/)). |
| <code>this machine cannot use the box's HTTPS port PORT (.<wbr>.<wbr>.<wbr>).<wbr> Open its hostnames on port PORT.<wbr></code> | Open the box's hostnames on the port the message names. |
| <code>box BOX's ports.<wbr>range .<wbr>.<wbr>.<wbr> overlaps box OTHER .<wbr>.<wbr>.<wbr></code> | Give each box its own [`ports.range`](/docs/reference/config/user/ports/). |

A lane listed under `skipped_lanes` is not mirrored because another lane serves the same hostnames; its note gives the command that switches to it ([Work with several boxes](/docs/how-to/remote/several-boxes/)).
