Skip to content
Select theme
Select languageEnglish

Environment variables

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

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
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
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