# Environment variables

## acdev

| Variable | Effect |
| --- | --- |
| `ACDEV_INSTALL` | Install directory, default `~/.acdev` |
| `ACDEV_DIST` | Where the installers download acdev and its runtime from, and where `acdev doctor --online` looks for a newer one; default `https://pkgs.dopame.ai/acdev` |
| `ACDEV_SDK` | The SDK directory `acdev new` and `acdev sdk update` point `@dopame/acde-api` at; default the one that comes with acdev |
| `ACDEV_VM_DIR` | Where `acdev vm` keeps the guest: images, the overlay disk, sockets, logs; default `~/.local/share/acdev/vm` |
| `ACDEV_VM_TRANSPORT` | How `acdev vm start` reaches acdevd in the guest: `vsock` (default on Linux), `tcp` (a forwarded port on 127.0.0.1, default on macOS and Windows) or `unix` (a forwarded Unix socket in the VM directory; only when set, and it needs a QEMU with `hostfwd=unix` support (merged upstream in October 2025; the first release with it is probably 10.2, not verified), libslirp 4.7.0 or newer, no Windows host, and no `-` in the socket path unless QEMU also has the June 2026 fix that splits the rule at the last dash; QEMU 8.2.2 says `Bad protocol name`) |
| `ACDEV_QEMU_DIR` | The directory with `qemu-system-x86_64` and `qemu-img` for `acdev vm` (searched before `PATH`; on Windows the registry and `%ProgramFiles%\qemu` come after `PATH`, on macOS Homebrew and MacPorts) |
| `ACDEVTOOL` | The `acdevtool` binary `acdev vm` runs: `acdevtool relay` on Windows to reach QEMU's QMP and guest agent sockets, `acdevtool view` for `acdev vm start --viewer` and `acdev vm view` (default: the installed `libexec/acdevtool`, else built from the checkout's `crates/tool`) |
| `ACDEV_VM_ARCH` | The guest architecture for `acdev vm`: `x86_64` or `aarch64` (default: `aarch64` on arm64 hosts such as Apple silicon, else `x86_64`) |
| `ACDEV_VM_CPUS` | How many CPUs `acdev vm start` gives the guest; default 4 |
| `ACDEV_VM_MEMORY` | How much memory `acdev vm start` gives the guest, in QEMU's form (`8G`, `4096M`); default `8G` |
| `ACDEV_VM_DIST` | Where `acdev vm fetch` downloads the guest disk images from; default acdev's own image server |
| `ACDEV_VM_PASSWORD` | The password `acdev vm provision` and `acdev test --vm` set for the guest's test user; default `dopame-dev` |
| `ACDEV_DEVD` | The acdevd binary (the device daemon) `acdev vm start` puts in the guest; when the file is not there, acdev stops with an error. Default: the one the installer put next to acdev for the guest's architecture (`libexec/acdevd-<arch>`) |
| `ACDEV_RUNTIME` | The runtime binary `acdev dev` and `acdev test` run: a path to the binary (not looked up on PATH; when the file is not there, acdev stops with an error). Unset: the one the installer put next to acdev, `libexec/acdev` of the install |
| `ACDEV_BUNDLER=vite` | Bundle with Vite on Bun too |
| `ACDEV_DEBUG=1` | An error also prints its stack trace (normally only the one-line message) |
| `ACDEV_BROWSER` | The browser `acdev devtools` and F12 in `acdev dev` open DevTools in: a path, or `none` to open nothing and only print the address. Unset: Edge, then Chrome on Windows; Chrome, then Edge on macOS; Chrome, Chromium or Edge on `PATH` on Linux |
| `CI` | When set, `toHaveScreenshot` does not write new baselines; a missing baseline fails right away |
| `NO_COLOR` | Set and not empty: no color in acdev's output |
| `FORCE_COLOR` | Set and not `0` or `false`: color even when the output is not a terminal |

## Runtime (acdev runtime)

`acdev dev` and `acdev test` set what is needed for you. To adjust things by hand:

| Variable | Effect |
| --- | --- |
| `ACDE_PATH` | Extra package directories (separated by `;` on Windows) |
| `ACDE_DESKTOP` | Default desktop |
| `ACDE_HEADLESS=1` | Don't open a window |
| `ACDE_SIZE` | Screen size, such as `1280x800` |
| `ACDE_SCALE` | Scale factor when headless (0.5–4) |
| `ACDE_COLOR_SCHEME` | `light` / `dark` |
| `ACDE_STORAGE` | Root directory for web storage; set it to empty to keep storage in memory only |
| `ACDE_AUTOSTART` | Autostart items run by default only in a Dopame OS session: `1` runs them in the host window too, `0` skips them |
| `ACDE_AUDIO=null` | No sound |
| `ACDE_CAPTURE=fake` | A fake camera and microphone (`Fake camera`, `Fake microphone`) in place of the system's devices, for `getUserMedia()` |
| `ACDE_FRAME_STYLE` | Title bar style: `mac` (traffic lights) or `windows` (Windows buttons). Unset: `windows` in the host window on Windows, else `mac` |

## App backends

| Variable | What it is |
| --- | --- |
| `ACDE_APP_ID` | The app id |
| `ACDE_APP_DATA` | The app's data directory (also its working directory) |
| `ACDE_APP_SOCKETS` | The app's socket directory. Not set for a Node.js backend on Windows, which gets `ACDE_APP_CHANNEL=fd` instead; see [Backend](https://docs.dopame.ai/guide/backend.md#on-windows) |
| `PORT` | The configured port |
| `NODE_ENV` | `production` |
| `http_proxy`, `https_proxy`, `all_proxy`, `no_proxy` | The session's proxy variables, or else the system's manual proxy (Windows, macOS) with its exceptions plus `localhost,127.0.0.1,::1` in `no_proxy`; upper-case names on Windows, both cases elsewhere. See [Backends](https://docs.dopame.ai/guide/backend.md#running) |
