Skip to content

devlanes is in beta and not ready for production use.Report an issue

Troubleshooting

devlanes debug why UNIT explains a unit that is not running or not ready, and devlanes doctor checks the machine. Text in capitals, such as UNIT, stands for the name devlanes prints there.

What you seeCauseFix
UNIT couldn't start: PROGRAM: command not found on PATHThe program is not on the PATH of the shell that started the laneStart the lane from a shell that finds it (Bring lanes back after a reboot)
UNIT wasn't ready in timeThe ready check never passedWait until a service is ready
nothing accepts connections on port PORTThe service listens on another port than the one devlanes gave itGive a service several ports and hostnames
A service crashed, and status still shows it readyA watcher such as node --watch keeps the process aliveRead devlanes logs for the service and run devlanes restart on it (When a service fails)
port PORT is taken by pid NAnother program holds a port of the laneStop that program, then start again
PATH has no value in LANEAn expression such as ${{ env.API_KEY }} has no value, often a missing .envRead .env values and pin tool versions
global_env.NAME has no value in LANE on each service, under a profile with infra: falseThe value reads a container the profile did not startShare settings and choose which services start
Docker isn't running or can't be reachedThe project has containers and Docker is downStart Docker
What you seeCauseFix
Lanes are idle with needs start from a shellThe daemon restarted, or ended with the terminalBring lanes back after a reboot
The daemon stops when you close a terminal on WindowsThat terminal ends the processes it startedWindows
devlanes: command not found in a project whose package.json lists devlanesThe project pins devlanes, so the command is not on your PATHRun it as npx devlanes (Install devlanes)
no devlanes.yaml in DIR or its parentsThe command ran outside a projectAdd devlanes to a project
the running daemon is devlanes VERSION ... and cannot serve this CLIThe daemon runs another release than the CLIdevlanes daemon restart (Update and uninstall)
the port pool has no free block of N ports for another laneOld lanes hold every port blockRemove lanes
auto-spawn refused in sandboxThe command runs inside an agent’s sandboxUse devlanes from an agent sandbox
What you seeCauseFix
A certificate error, such as ERR_CERT_AUTHORITY_INVALIDThis browser or tool does not trust the devlanes CATrust the devlanes CA
HTTPS fails with no page for a hostnameNo lane routes that hostnameCheck the name with devlanes url ls (Give a service several ports and hostnames)
A program cannot resolve a *.localhost nameIts resolver does not send *.localhost to your machineFix programs that cannot resolve *.localhost
URLs end in :8443 or :8080Another program holds port 443 or 80Choose the proxy’s ports
DL201 Service not runningThe service or its lane is stoppedStart it with the command the page shows
DL203 Service failedThe service exited or failed its ready checkdevlanes debug why UNIT
What you seeCauseFix
needs_auth in devlanes remote lsReconnecting needs your SSH password, passphrase or host keydevlanes remote connect BOX in a terminal
needs_pairing in devlanes remote lsThe box no longer accepts this machineConnect to a box
Other states and warnings of devlanes remote lsRemote connection states