env.example

# Settings for the devcontainer:* tasks and the bootstrap scripts. Copy to
# .devcontainer/.env (gitignored) and uncomment what you need. Every value can
# also be set as a plain environment variable; explicit CLI parameters win.
# Loaded by Task (root Taskfile `dotenv:`) and by bootstrap.ps1/bootstrap.sh.
# Precedence in the tasks: a var on the command line
# (`task devcontainer:up DEVCONTAINER_DOCKER_PATH=docker`) beats this file,
# which beats an exported environment variable. Nothing in here is a
# credential; it holds machine-local choices only.

# Docker-compatible CLI handed to `devcontainer --docker-path`: a command name
# on PATH (docker, wslc, podman, nerdctl, finch) or a full path. Unset =
# docker on PATH, else wslc.exe on Windows. Images, containers and named
# volumes belong to the engine chosen: keep to one engine per machine.
#DEVCONTAINER_DOCKER_PATH=wslc

# The kind of host the launcher runs on: auto (default: the first id of
# HOST_TYPE_PRIORITY whose detection passes), or one of windows-docker,
# windows-wsl-docker, windows-wslc, linux, macos (skips detection). The launcher
# sets DCF_HOST_TYPE, DCF_HOST_HOME and DCF_HOST_SSH_AGENT from it; see them with
# `task devcontainer:host`. DEVCONTAINER_DOCKER_PATH above still names the engine
# when set.
#HOST_TYPE=auto
# Ordered, comma-separated ids that auto tries; default per OS: Windows
# windows-docker,windows-wsl-docker,windows-wslc; inside WSL windows-wsl-docker;
# Linux linux; macOS macos. An organisation that wants Docker in WSL first:
#HOST_TYPE_PRIORITY=windows-wsl-docker,windows-docker,windows-wslc

# A host folder a sync client keeps (a SharePoint or OneDrive folder) that
# `task devcontainer:up` bind-mounts at /mnt/cloud-folder-host, for material that
# must never go in git; the cloud-folder Feature links its mountPoint option
# there, so the path in the container is named once, in that option. Unset = no
# folder. The launcher never creates it: a path missing on this machine is
# skipped with a warning. Map it with containerEnv (the bootstrap's
# devcontainer.json does).
#DCF_HOST_CLOUD_FOLDER=C:\Users\<you>\<synced library>\<folder>

# Portable Node.js and @devcontainers/cli versions used by the host-side
# tasks (cached per user; nothing installed globally).
#DEVCONTAINER_NODE_VERSION=24.21.0
#DEVCONTAINER_CLI_VERSION=latest

# Root of the host-side folders that devcontainer.json bind-mounts for tool
# state (task devcontainer:homes). Default: %USERPROFILE%\.devcontainer-homes
# on Windows, ~/.devcontainer-homes elsewhere. The mounts in devcontainer.json
# name the folder literally, so change both or neither.
#DEVCONTAINER_HOMES=

# Command `task devcontainer:stop` runs inside the container before it stops
# it; a non-zero exit refuses the stop (FORCE=1 skips it). Unset = the repo's
# `task shutdown:check`, else the devhost Feature's devhost-shutdown-check, else
# none (bootstrap/SHUTDOWN.md). Set it only to override that.
#STOP_CHECK=

# The Claude Code host session: the UUID of the one session `task
# devcontainer:claude` resumes (created under that UUID if it does not exist
# yet). The name shown in Claude Code is only a label and may change with
# /rename; the UUID (see /status) finds the session. HOST_SESSION_<DIR> does
# the same for a sub-folder started with DIR=<path> (DIR=rooms/solis reads
# HOST_SESSION_SOLIS). Unset: a plain new session.
#HOST_SESSION=

# Bootstrap only: the folder to vendor into, relative to the repository root
# (no absolute path, no ..). Default .devcontainer/cli_bootstrap.ignore. The
# root Taskfile include must name the same folder (the bootstrap writes it for
# a new Taskfile; for an existing one it prints the line). Also a bootstrap
# parameter: -BootstrapDir / --bootstrap-dir.
#BOOTSTRAP_DIR=.devcontainer/cli_bootstrap.ignore
# false = do not git-ignore that folder (default: the bootstrap adds it to
# .devcontainer/.gitignore, or the root .gitignore when BOOTSTRAP_DIR is outside
# .devcontainer/). Also -NoGitignore / --no-gitignore.
#BOOTSTRAP_GITIGNORE=false

# Bootstrap only: which ref of nabil-becker/devcontainer-features to vendor
# from, an alternative source (URL base or local checkout), and whether to
# stop before `task devcontainer:up`.
#DEVCONTAINER_BOOTSTRAP_REF=main
#DEVCONTAINER_BOOTSTRAP_SOURCE=https://raw.githubusercontent.com/nabil-becker/devcontainer-features/main
#DEVCONTAINER_BOOTSTRAP_NO_UP=true