Skip to content

envd CLI Reference

This is a reference for the CLI commands of envd.

TIP

The documentation is auto-generated from envd app, please do not edit it manually.

NAME

envd - Development environment for data science and AI/ML teams

SYNOPSIS

envd

[--analytics-enabled]
[--debug]
[--help|-h]

Usage:

envd [GLOBAL OPTIONS] command [COMMAND OPTIONS] [ARGUMENTS...]

GLOBAL OPTIONS

--analytics-enabled: enable analytics

--debug: enable debug output in logs

--help, -h: show help

COMMANDS

bootstrap

Bootstrap the envd installation

--buildkit, -b: Download the image and bootstrap buildkit

--dockerhub-mirror, -m="": DockerHub mirror to use

--registry, -r="": Specify the registry to pull the image from (default: "docker.io")

--registry-ca-keypair, --ca="": Specify the ca/key/cert file path for the private registry (format: 'ca=/etc/config/ca.pem,key=/etc/config/key.pem,cert=/etc/config/cert.pem')

--registry-config="": Path to a JSON file containing registry configuration. Cannot be used with 'registry' or 'registry-ca-keypair'

--ssh-keypair, -k="": Manually specify ssh key pair as publicKey,privateKey. envd will generate a keypair at /home/runner/.config/envd/id_rsa_envd.pub and /home/runner/.config/envd/id_rsa_envd if not specified

--use-http: Use HTTP instead of HTTPS for the registry

--with-autocomplete: Add envd auto-completions

run, c

Run the envd environment from the existing image

--cpus="": Request CPU resources (number of cores), such as 0.5, 1, 2

--detach: Detach from the container

--gpu="": Request GPU resources (number of gpus), such as 1, 2

--host="": Assign the host address for the environment SSH access server listening (default: "127.0.0.1")

--image="": image name (default: PROJECT:dev)

--memory="": Request Memory, such as 512M, 2G

--name="": environment name

--path, -p="": Working directory path to be used as project root (default: ".")

--shm-size="": Configure the shared memory size (megabyte) (default: 2048)

--sync: Sync the local directory with the remote container

--timeout="": Timeout of container creation (default: 30m0s)

--volume, -v="": Mount host directory into container

completion

Install shell completion scripts for envd

--no-install: Only output the completion script and don't install it

--shell, -s="": Shell type to install completion

context

Manage envd contexts

create

Create envd context

--builder="": Builder to use (docker-container, kube-pod, tcp, unix, moby-worker, nerdctl-container) (default: "docker-container")

--builder-address="": Builder address (default: "envd_buildkitd")

--name="": Name of the context

--runner="": Runner to use(docker, envd-server) (default: "docker")

--runner-address="": Runner address

--use: Use the context

ls

List envd contexts

--format, -f="": Format of output, could be "json" or "table" (default: "table")

rm

Remove envd context

--name="": Name of the context

use

Use the specified envd context

--name="": Name of the context

build, b

Build the envd environment

--export-cache, --ec="": Export the cache (e.g. type=registry,ref=<image>). The default moby-worker builder doesn't support this unless the docker-ce has enabled the containerd image store. You can run envd context create --name docker --builder docker-container --use to use this feature.

--force: Force rebuild the image

--from, -f="": Function to execute, format file:func (default: "build.envd:build")

--import-cache, --ic="": Import the cache (e.g. type=registry,ref=<image>)

--output, -o="": Output destination (e.g. type=tar,dest=path,push=true)

--path, -p="": Path to the directory containing the build.envd (default: ".")

--platform="": Specify the target platforms for the build output (for example, "windows/amd64" or "linux/amd64,darwin/arm64"). Build images with same tags could cause image overwriting, platform suffixes will be added to differentiate the images. (default: linux/amd64)

--tag, -t="": Name and optionally a tag in the 'name:tag' format (default: PROJECT:dev)

--use-proxy, --proxy: Use HTTPS_PROXY/HTTP_PROXY/NO_PROXY in the build process

destroy, down, d

Destroy the envd environment

--name, -n="": Name of the environment or container ID

--path, -p="": Path to the directory containing the build.envd (default: current directory)

envs, env, e

Manage envd environments

describe, d

Show details about environments, including dependencies and port binding

--env, -e="": Specify the envd environment to use (default: "envd-docs")

--format, -f="": Format of output, could be "json" or "table" (default: "table")

list, ls, l

List envd environments

--format, -f="": Format of output, could be "json" or "table" (default: "table")

images, image

Manage envd images

describe, d

Show details about image, including dependencies

--format, -f="": Format of output, could be "json" or "table" (default: "table")

--image, -i="": Specify the image to use

list, ls, l

List envd images

--format, -f="": Format of output, could be "json" or "table" (default: "table")

prune

Remove unused images

remove, r, rm

Remove an envd image

--image, -i="": Specify the image name to be removed

--tag, -t="": Remove the image with a specific tag (default: dev)

init, i

Automatically generate the build.envd

--force, -f: overwrite the build.envd if existed

--lang, -l="": language usage. Support Python, R, Julia

--path, -p="": Path to the directory containing the build.envd (default: ".")

login

Login to the envd server defined in the current context

--password, -p="": password

--username, -u="": the login name in envd server

pause, p

Pause the envd environment

--env, -e="": Environment name

prune

Clean up the build cache

--all: Include internal caches (oh-my-zsh, vscode extensions and other envd caches)

--keep-duration="": Keep data newer than this limit (default: 0s)

--keep-storage="": Keep data below this limit (in MB) (default: 0)

--verbose: Verbose output

exec

Spawns a command installed into the environment.

--command, -c="": Command defined in build.envd to execute

--from, -f="": Function to execute, format file:func (default: "build.envd:build")

--name, -n="": Name of the environment

--path, -p="": Path to the directory containing the build.envd (default: ".")

--raw, -r="": Raw command to execute

resume, r

Resume the envd environment

--env, -e="": Environment name

up, u

Build and run the envd environment

--cpu-set="": Limit the specific CPUs or cores the environment can use, such as 0-3, 1,3

--cpus="": Request CPU resources (number of cores), such as 0.5, 1, 2

--detach: Detach from the container

--export-cache, --ec="": Export the cache (e.g. type=registry,ref=<image>). The default moby-worker builder doesn't support this unless the docker-ce has enabled the containerd image store. You can run envd context create --name docker --builder docker-container --use to use this feature.

--force: Force rebuild and run the container although the previous container is running

--from, -f="": Function to execute, format file:func (default: "build.envd:build")

--gpu-set="": GPU devices used in this environment, such as all, '"device=1,3"', count=2(all to pass all GPUs). This will override the --gpus

--gpus="": Number of GPUs used in this environment, this will override the config.gpu() (default: 0)

--host="": Assign the host address for the environment SSH access server listening (default: "127.0.0.1")

--import-cache, --ic="": Import the cache (e.g. type=registry,ref=<image>)

--memory="": Request Memory, such as 512Mb, 2Gb

--name="": environment name

--no-gpu: Launch the CPU container even if it's a GPU image

--path, -p="": Path to the directory containing the build.envd (default: ".")

--platform="": Specify the target platform for the build output, (for example, windows/amd64, linux/amd64, or darwin/arm64) (default: linux/amd64)

--shm-size="": Configure the shared memory size (megabyte) (default: 2048)

--tag, -t="": Name and optionally a tag in the 'name:tag' format (default: PROJECT:dev)

--timeout="": Timeout of container creation (default: 30s)

--use-proxy, --proxy: Use HTTPS_PROXY/HTTP_PROXY/NO_PROXY in the build process

--volume, -v="": Mount host directory into container

debug

Debug commands

llb, b

dump buildkit LLB in human-readable format.

--dot: Output dot format

--from, -f="": Function to execute, format file:func (default: "build.envd:build")

--path, -p="": Path to the directory containing the build.envd (default: ".")

version, v

Print envd version information

--detail, -d: Print details about the envd environment

--format, -f="": Format of output, could be "json" or "table" (default: "table")

--short, -s: Only print the version number

top

Show statistics about the containers managed by the environment.

reference

Print envd reference documentation

--help, -h: show help

--output="": Output file, if not specified, print to stderr

help, h

Shows a list of commands or help for one command

new, n

Create a new build.envd file from pre-defined templates

--force, -f: Overwrite the build.envd if existed

--path, -p="": Path to the directory of the build.envd (default: ".")

--template, -t="": Template name to use (envd bootstrap will add some default templates to '$HOME/.config/envd/templates')

Released under the Apache-2.0 License. Built with VitePress.