Use or extend the new Ubuntu-based default, large, and multi-language universal image which contains many popular languages/frameworks/SDKS/runtimes

See history for information on the contents of published images.

While language specific development containers can be useful, in some cases you may want to use more than one in a project without having to set them all up. In other cases you may be looking to create a general "sandbox" container you intend to use with multiple projects or repositories. The large container image generated here (mcr.microsoft.com/devcontainers/universal:linux) includes a number of runtime versions for popular languages like Python, Node, PHP, Java, Go, C++, Ruby, and .NET Core/C#.

If you use GitHub Codespaces, this is the "universal" image that is used by default if no custom Dockerfile or image is specified. If you like what you see but want to make a few additions or changes, you can use a custom Dockerfile to extend it and add whatever you need.

The container includes the zsh (and Oh My Zsh!) and fish shells that you can opt into using instead of the default bash. It also includes rbenv, and SDKMAN! if you need to install a different version Node, Ruby, or Java tools than the container defaults. You can also set things up to access the container via SSH.

You can decide how often you want updates by referencing a semantic version of each image. For example:

• mcr.microsoft.com/devcontainers/universal:2-focal
• mcr.microsoft.com/devcontainers/universal:2.0-focal
• mcr.microsoft.com/devcontainers/universal:2.0.6-focal

See history for information on the contents of each version and here for a complete list of available tags.

This container also includes a running SSH server that you can use to access the contents if needed. To use it, refer to the SSHD Feature for instructions.

This dev container and its associated image includes configuring Conda channels here.

Access to the Anaconda repository is covered by the Anaconda Terms of Service, which may require some organizations to obtain a commercial license from Anaconda. However, when this dev container or its associated image is used with GitHub Codespaces or GitHub Actions, all users are permitted to use the Anaconda Repository through the service, including organizations normally required by Anaconda to obtain a paid license for commercial activities. Note that third-party packages may be licensed by their publishers in ways that impact your intellectual property, and are used at your own risk.

While the image itself works unmodified, you can also directly reference pre-built versions of Dockerfile by using the image property in .devcontainer/devcontainer.json or updating the FROM statement in your own Dockerfile to:

mcr.microsoft.com/devcontainers/universal:2-linux

Alternatively, you can use the contents of .devcontainer to fully customize your container's contents or to build it for a container host architecture not supported by the image.

Refer to this guide for more details.

Codespaces will automatically perform some default setup when the universal image is used and no postCreateCommand is provided. This can be disabled with the customizations.codespaces.disableAutomaticConfiguration setting:

"customizations": {
	/ Configure properties specific to Codespaces.
	"codespaces": {
		"disableAutomaticConfiguration": true
	}
}

Copyright (c) Microsoft Corporation. All rights reserved.

Licensed under the MIT License. See LICENSE.