Skip to content

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

Glossary

The words the devlanes docs use most, in alphabetical order, each with the page that explains it.

TermMeaningExplained in
BoxA machine whose lanes show up on another.Remote mirroring
CAThe certificate authority devlanes creates on your machine to sign the certificates of its hostnames.Hostnames and HTTPS
ContainerSomething under infra, such as a Compose service.A database for each lane
DaemonThe background process that runs the lanes.The daemon
Data folderA folder of each lane outside its worktree, read as ${{ lane.data_path }}.Files and folders
DriftA difference between what a lane runs and what its project file now says, which devlanes reload applies.Config files and reload
ExpressionA ${{ ... }} value in the project file, evaluated for each lane.Expressions
Frozen, thawA lane nobody uses is suspended, and runs again on its next request, connection or command.Throttling and freezing
HostnameA name the proxy serves over HTTPS, such as api.myapp1.localhost.Hostnames and HTTPS
LaneOne worktree’s place to run the project, with ports, hostnames and data of its own.Lanes and projects
Lane 0The lane of the worktree that has the project’s primary branch, such as main, checked out.Lanes and projects
Lane domainThe domain a lane’s hostnames end in: myapp.localhost in lane 0, myapp1.localhost in lane 1.Hostnames and HTTPS
Lane namemain for lane 0 and lane<N> for lane N.Lanes and projects
Local filedevlanes.local.yaml: one developer’s changes to the project file, kept out of Git.Keep personal changes out of Git
PairingProving to a box, with a one-time code from devlanes daemon pair, that your machine may connect to it.Security
Port blockThe range of consecutive ports each lane gets.Ports
PresetA service setting, such as preset: vite, that passes a framework its port and other per-lane settings.Services that find each other
ProfileA named set of services, and their settings, that a start can select.Share settings and choose which services start
ProjectWhat one devlanes.yaml describes.Lanes and projects
Project filedevlanes.yaml.A service, a port and a hostname
ProxyThe part of the daemon that serves every hostname over HTTPS and passes each request to its lane.Hostnames and HTTPS
Ready checkready: how devlanes decides that a service works.Wait until a service is ready
Reloaddevlanes reload, which applies changes to the project file to the running lane.Config files and reload
ServiceA long-running process of a lane.A service, a port and a hostname
Setupinfra.setup entries: commands run once per lane after its containers are ready, such as creating its database.A database for each lane
Shared containerA container every lane of the project uses, such as one Postgres with a database per lane.Share one database server between lanes
TaskA one-off command of a lane, such as an install or a migration.Run installs, migrations and seeds
UnitA service, task or command that a lane runs.Lane and unit references
User config~/.devlanes/config.yaml.Files and folders
WorktreeA Git worktree.Every worktree gets a lane