Report a bug
Use this when devlanes does something you did not expect and you want someone to reproduce it. Collect everything while the problem is happening: stopping or restarting the daemon loses most of it.
A coding agent with the devlanes skill can collect this and draft the issue. Ask it to investigate the problem and draft a bug report, read the draft before it is posted, and attach the bundle yourself.
Check the machine
Section titled “Check the machine”$ devlanes doctorThe doctor checks the daemon, Docker, the proxy, the CA and hostname lookups, prints a fix under each line that is off, and names the version and how devlanes was installed. When a service is the problem, devlanes debug why with the service’s name gives the reasons.
Make a debug bundle
Section titled “Make a debug bundle”Add the command that goes wrong after the two dashes. The bundle runs it again with full diagnostics, so a start really starts the service.
$ devlanes debug bundle -- start apiIt writes an archive with the versions, the doctor’s checks, the status of the lanes, the end of the daemon’s log and the output of that command, and prints where the archive is. Values of variables named like tokens, keys or passwords are replaced, but a secret under another name stays, so read the files before you attach them.
File the issue
Section titled “File the issue”Open a bug report. The form asks for your versions, what happened, the steps, what you expected and the bundle. Add the lines of the project file involved, with secrets removed.
If the daemon’s log needs more detail
Section titled “If the daemon’s log needs more detail”Restart the daemon with a debug level, then do what goes wrong again and make the bundle. The restart stops your services and starts them again.
macOS
$ DEVLANES_LOG=debug devlanes daemon restartLinux
$ DEVLANES_LOG=debug devlanes daemon restartWindows
PS> $env:DEVLANES_LOG = "debug"; devlanes daemon restartIf it is a security problem
Section titled “If it is a security problem”Do not open a public issue. Follow the devlanes-run security policy.