latest--devContainer.base.schema
shared| Type | object |
|---|---|
| Schema URL | https://catalog.lintel.tools/schemas/schemastore/devcontainer-json/_shared/latest--devContainer.base.schema.json |
| Parent schema | devcontainer-json |
Defines a dev container
One of
Definitions
The JSON schema of the devcontainer.json file.
A name for the dev container which can be displayed to the user.
Features to add to the dev container.
5 nested properties
Array consisting of the Feature id (without the semantic version) of Features in the order the user wants them to be installed.
Recommended secrets for this dev container. Recommendations are provided as environment variable keys with optional metadata.
Ports that are forwarded from the container to the local machine. Can be an integer port number, or a string of the format "host:port_number".
Set default properties that are applied when a specific port number is forwarded. For example:
"3000": {
"label": "Application"
},
"40000-55000": {
"onAutoForward": "ignore"
},
".+\\/server.js": {
"onAutoForward": "openPreview"
}
Set default properties that are applied to all ports that don't get properties from the setting remote.portsAttributes. For example:
{
"onAutoForward": "ignore"
}
5 nested properties
Defines the action that occurs when the port is discovered for automatic forwarding
Automatically prompt for elevation (if needed) when this port is forwarded. Elevate is required if the local port is a privileged port.
Label that will be shown in the UI for this port.
When true, a modal dialog will show if the chosen local port isn't used for forwarding.
The protocol to use when forwarding this port.
Controls whether on Linux the container's user should be updated with the local user's UID and GID. On by default when opening from a local folder.
Container environment variables.
The user the container will be started with. The default is the user on the Docker image.
Mount points to set up when creating the container. See Docker's documentation for the --mount option for the supported syntax.
Passes the --init flag when creating the dev container.
Passes the --privileged flag when creating the dev container.
Passes docker capabilities to include when creating the dev container.
Passes docker security options to include when creating the dev container.
Remote environment variables to set for processes spawned in the container including lifecycle scripts and any remote editor/IDE server process.
The username to use for spawning processes in the container including lifecycle scripts and any remote editor/IDE server process. The default is the same user as the container.
A command to run locally (i.e Your host machine, cloud VM) before anything else. This command is run before "onCreateCommand". If this is a single string, it will be run in a shell. If this is an array of strings, it will be run as a single command without shell. If this is an object, each provided command will be run in parallel.
A command to run when creating the container. This command is run after "initializeCommand" and before "updateContentCommand". If this is a single string, it will be run in a shell. If this is an array of strings, it will be run as a single command without shell. If this is an object, each provided command will be run in parallel.
A command to run when creating the container and rerun when the workspace content was updated while creating the container. This command is run after "onCreateCommand" and before "postCreateCommand". If this is a single string, it will be run in a shell. If this is an array of strings, it will be run as a single command without shell. If this is an object, each provided command will be run in parallel.
A command to run after creating the container. This command is run after "updateContentCommand" and before "postStartCommand". If this is a single string, it will be run in a shell. If this is an array of strings, it will be run as a single command without shell. If this is an object, each provided command will be run in parallel.
A command to run after starting the container. This command is run after "postCreateCommand" and before "postAttachCommand". If this is a single string, it will be run in a shell. If this is an array of strings, it will be run as a single command without shell. If this is an object, each provided command will be run in parallel.
A command to run when attaching to the container. This command is run after "postStartCommand". If this is a single string, it will be run in a shell. If this is an array of strings, it will be run as a single command without shell. If this is an object, each provided command will be run in parallel.
The user command to wait for before continuing execution in the background while the UI is starting up. The default is "updateContentCommand".
User environment probe to run. The default is "loginInteractiveShell".
Host hardware requirements.
4 nested properties
Number of required CPUs.
Amount of required RAM in bytes. Supports units tb, gb, mb and kb.
Amount of required disk space in bytes. Supports units tb, gb, mb and kb.
Tool-specific configuration. Each tool should use a JSON object subproperty with a unique name to group its customizations.
Application ports that are exposed by the container. This can be a single port or an array of ports. Each port can be a number or a string. A number is mapped to the same port on the host. A string is passed to Docker unchanged and can be used to map ports differently, e.g. "8000:8010".
The arguments required when starting in the container.
Action to take when the user disconnects from the container in their editor. The default is to stop the container.
Whether to overwrite the command specified in the image. The default is true.
The path of the workspace folder inside the container.
The --mount parameter for docker run. The default is to mount the project folder at /workspaces/$project.
Target stage in a multi-stage build.
Build arguments.
The image to consider as a cache. Use an array to specify multiple images.
Additional arguments passed to the build command.
The docker image that will be used to create the container.
The name of the docker-compose file(s) used to start the services.
The service you want to work on. This is considered the primary container for your dev environment which your editor will connect to.
The path of the workspace folder inside the container. This is typically the target path of a volume mount in the docker-compose.yml.
An array of services that should be started and stopped.
Action to take when the user disconnects from the primary container in their editor. The default is to stop all of the compose containers.
Whether to overwrite the command specified in the image. The default is false.
Mount type.
Mount target.
Mount source.