Skip to content

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

Install devlanes

devlanes is a single command. Its background daemon starts by itself the first time you use it.

Your coding agent can install it for you, apart from one dialog your operating system shows you.

Install the devlanes skill:
npx skills add devlanes-run/devlanes --skill devlanes
Then install devlanes on this machine, set up everything it needs,
and help me port this project to devlanes from whatever runs it today.

devlanes runs on macOS, on Linux with glibc, and on Windows 11 version 24H2 or later with Git for Windows. Install it with the package manager you already use.

Homebrew

Terminal window
$ brew install devlanes-run/tap/devlanes

Homebrew has builds for macOS and Linux.

npm

Terminal window
$ npm install -g devlanes

uv

Terminal window
$ uv tool install devlanes

cargo

Terminal window
$ cargo binstall --git https://github.com/devlanes-run/devlanes devlanes
$ cargo binstall --git https://github.com/devlanes-run/devlanes devlanes-hosts-helper

You install it once. devlanes then keeps itself on the latest patch release in the background, and Update and uninstall covers the rest.

macOS

Terminal window
$ curl -fsSL https://devlanes.run/install.sh | sh

Linux

Terminal window
$ curl -fsSL https://devlanes.run/install.sh | sh

Windows

Terminal window
PS> irm https://devlanes.run/install.ps1 | iex

Open a new terminal afterwards.

devlanes serves each hostname over HTTPS with certificates signed by the devlanes CA, a certificate authority it creates on your machine. The CA can only sign names meant for local development, such as those ending in .localhost.

Terminal window
$ devlanes setup

The command lists what it is about to change, asks once and adds the CA to your system’s trust store. Your operating system then asks for a password or a confirmation. devlanes setup --remove undoes it.

Browsers on Linux and some command-line tools keep certificate stores of their own. Trust the devlanes CA covers those.

Terminal window
$ devlanes doctor

The doctor checks what a first start depends on and prints a fix under each line that is off. A project with containers also needs Docker running.

A JavaScript project can list devlanes as a dependency, so everyone who works on it runs the same release:

~/dev/myapp
$ npm install --save-dev devlanes
$ npx devlanes start

The command is then not on your PATH, so you run it through the package manager, as the second line does; pnpm, Yarn and Bun have their own form, such as pnpm devlanes.

One daemon serves every project on the machine, so it can run another release than the one the project pins. The doctor shows both versions when they differ. To move the daemon to the pinned release, restart it from the project, which stops your running services and starts them again:

~/dev/myapp
$ npx devlanes daemon restart

Add the line for your shell to its startup file.

bash

~/.bashrc
eval "$(devlanes completions bash)"

zsh

~/.zshrc
autoload -Uz compinit && compinit
source <(devlanes completions zsh)

fish

~/.config/fish/config.fish
devlanes completions fish | source

PowerShell

$PROFILE
devlanes completions powershell | Out-String | Invoke-Expression