Skip to content

Latest commit

 

History

History
41 lines (26 loc) · 1.49 KB

File metadata and controls

41 lines (26 loc) · 1.49 KB

Create Remote User (create-remote-user)

A feature to assert the configured remote user exists in the container and optionally add them to additional groups

Example Usage

"features": {
    "ghcr.io/nils-geistmann/devcontainers-features/create-remote-user:0": {}
}

Options

Options Id Description Type Default Value
create Create the user if it doesn't exist boolean true
addToSudo If the user is newly created, add it to group sudo (if it exists) boolean true
installSudo Install sudo if it is not yet installed boolean true
passwordLessSudo Configures sudo to allow the remote user to elevate permissions without password boolean false
additionalGroups Comma-separated list of additional groups to add the user to (e.g., 'audio,video,docker') string -

OS Support

This feature currently only supports Debian based containers (where APT is used as package manager).

bash is required to run the install script.

Remarks

When create is set to true and the user does not exist, the user is created and given a password that equals its name.

⚠️ If the user already exists, the password is not changed. If no password is set, it is not possible to use sudo.


Note: This file was auto-generated from the devcontainer-feature.json. Add additional notes to a NOTES.md.