# axx env

> The services Axx started (running, left over, not cleaned up); env up and env down start and stop them

Source: https://axx.nimbusxr.us/references/cli/axx-env/

Report the services Axx started from axx.yaml, as the Axx MCP server's env tool
does: running (axx up, or a run, still holds them), left over (they run, but
what started them does not: axx down stops them) or not cleaned up (their
cleanup failed or never ran: axx down runs it). env status is axx env;
env up and env down are axx up and axx down.

```text
Usage:
  axx env [flags]
  axx env [command]

Available Commands:
  down        Stop services started by `axx up` (and any left behind by an interrupted run)
  status      The services axx started (the same as `axx env`)
  up          Start the services from axx.yaml and keep them running between `axx run`s

Flags:
  -D, --define stringArray   set a property for ${sys:name}, e.g. -D local.host=docker
  -h, --help                 help for env
      --profile string       apply profiles.<name> / axx.<name>.yaml, several comma-separated in order, like watch,ios (env: AXX_PROFILE)
      --set stringArray      set a key of axx.yaml for this run, over its files and profiles, e.g. --set run.workers=1 or --set packs.<pack>.<key>=value

Global Flags:
      --compact         print only what matters (auto-enabled for coding agents)
  -c, --config string   path to axx.yaml (default: search upward from the working directory)
      --json            emit machine-readable JSON (stable envelope)
      --no-color        disable colored output
  -v, --verbose count   increase log verbosity (-v, -vv)

Use "axx env [command] --help" for more information about a command.
```

## axx env down

Stop services started by `axx up` (and any left behind by an interrupted run)

```text
Usage:
  axx env down [flags]

Flags:
  -D, --define stringArray   set a property for ${sys:name}, e.g. -D local.host=docker
  -h, --help                 help for down
      --profile string       apply profiles.<name> / axx.<name>.yaml, several comma-separated in order, like watch,ios (env: AXX_PROFILE)
      --set stringArray      set a key of axx.yaml for this run, over its files and profiles, e.g. --set run.workers=1 or --set packs.<pack>.<key>=value

Global Flags:
      --compact         print only what matters (auto-enabled for coding agents)
  -c, --config string   path to axx.yaml (default: search upward from the working directory)
      --json            emit machine-readable JSON (stable envelope)
      --no-color        disable colored output
  -v, --verbose count   increase log verbosity (-v, -vv)
```

## axx env status

The services Axx started (the same as `axx env`)

```text
Usage:
  axx env status [flags]

Flags:
  -D, --define stringArray   set a property for ${sys:name}, e.g. -D local.host=docker
  -h, --help                 help for status
      --profile string       apply profiles.<name> / axx.<name>.yaml, several comma-separated in order, like watch,ios (env: AXX_PROFILE)
      --set stringArray      set a key of axx.yaml for this run, over its files and profiles, e.g. --set run.workers=1 or --set packs.<pack>.<key>=value

Global Flags:
      --compact         print only what matters (auto-enabled for coding agents)
  -c, --config string   path to axx.yaml (default: search upward from the working directory)
      --json            emit machine-readable JSON (stable envelope)
      --no-color        disable colored output
  -v, --verbose count   increase log verbosity (-v, -vv)
```

## axx env up

Start the services (all enabled ones, or the ones named) in the background and
wait until they are ready. Later `axx run` invocations reuse them instead of
starting and stopping them each time, which is the fastest local loop.
Stop them with `axx down`. Service output goes to .axx/logs/services.log.

```text
Usage:
  axx env up [services...] [flags]

Flags:
      --debug string[="*"]   start services with their debug command (all, or a comma-separated list)
  -D, --define stringArray   set a property for ${sys:name}, e.g. -D local.host=docker
  -h, --help                 help for up
      --profile string       apply profiles.<name> / axx.<name>.yaml, several comma-separated in order, like watch,ios (env: AXX_PROFILE)
      --set stringArray      set a key of axx.yaml for this run, over its files and profiles, e.g. --set run.workers=1 or --set packs.<pack>.<key>=value

Global Flags:
      --compact         print only what matters (auto-enabled for coding agents)
  -c, --config string   path to axx.yaml (default: search upward from the working directory)
      --json            emit machine-readable JSON (stable envelope)
      --no-color        disable colored output
  -v, --verbose count   increase log verbosity (-v, -vv)
```