---
title: "profiles in devlanes.yaml"
url: https://devlanes.run/docs/reference/config/project/profiles/
description: "Reference for the profiles key in devlanes.yaml."
---

# profiles in devlanes.yaml

A top-level key of [`devlanes.yaml`](/docs/reference/config/project/).

## `profiles`

Type: mapping of names.

Named selections of services for `devlanes start --profile <name>`. A plain `devlanes start` brings back what the lane ran before; `default` is used when there is nothing to bring back, such as after `devlanes stop`. A profile is a list of names, globs and `+tag` selectors, or a mapping that can also exclude services, skip infra, add `env` and remap script names.

```yaml devlanes
profiles:
  default:
    - +api
    - +web
  e2e:
    include:
      - "*"
    run_scripts:
      dev: start
```

### `profiles.<name>`

Type: list of strings or mapping.

Services started by `devlanes start --profile <name>` (`default` when no profile is given): a list of names, globs and `+tag` selectors, or a mapping that can also exclude services, skip infra, add `env` and remap script names. Several `--profile` flags start the union.

```yaml devlanes
profiles:
  default:
    - +api
    - +web
```

### `profiles.<name>.env`

Type: mapping of names to strings, booleans, numbers or [expressions](/docs/reference/expressions/).

Variables for the services, tasks and `infra.setup` and `infra.teardown` commands of a lane while this profile is active, and for `devlanes exec` and `devlanes with` when they read neither `self` nor `replica`. They sit above each unit's own `env`, which cannot override them, so put a variable that some task must not get, such as `NODE_ENV: production` next to an install task that needs devDependencies, in `global_env` instead.

```yaml devlanes
profiles:
  default:
    env:
      LOG_LEVEL: warn
```

### `profiles.<name>.exclude`

Type: list of strings.

Services removed from the `include` selection, by name, glob or `+tag`.

```yaml devlanes
profiles:
  default:
    exclude:
      - +desktop
      - sms-stub
```

### `profiles.<name>.include`

Type: list of strings.

Services this profile starts: names, globs such as `crm-*`, and `+tag` selectors. Globs skip services with `autostart: false`; names and tags include them.

```yaml devlanes
profiles:
  default:
    include:
      - +api
      - +web
```

### `profiles.<name>.infra`

Type: boolean or an [expression](/docs/reference/expressions/).

Set false to skip containers and `infra.setup`, for example to run only a frontend against another lane's backend. A value that reads `infra.*` then resolves only while its container already runs, as a shared one another lane started does. Otherwise a service or task whose `env` reads it fails to start, and so does every service and task of the lane when `global_env` or a profile's `env` reads it. With several profiles active, infra is skipped only when all of them set false. Defaults to true.

```yaml devlanes
profiles:
  default:
    infra: false
```

### `profiles.<name>.run_scripts`

Type: mapping of names to strings.

Swap script names for services that use `run_script`: `{ dev: start }` runs the `start` script wherever a service's `run_script` names `dev`. The file stays the same, and each name is swapped once, not chained. The whole `name` is matched, so a Maven or Gradle `name` such as `spring-boot:run -Pdev` is swapped only by that exact text.

```yaml devlanes
profiles:
  default:
    run_scripts:
      dev: start
```
