Changing user ID - env zero docs

GET STARTED

ENVIRONMENTS & DEPLOYMENTS

TEMPLATES & IaC TOOLS

PLATFORM CONFIGURATION

SELF-HOSTED AGENTS

CLOUD MANAGEMENT

GOVERNANCE & POLICIES

ACCESS & IDENTITY

SECURITY & COMPLIANCE

INTEGRATIONS & DEVELOPER TOOLS

BILLING & SUPPORT

Our default image use node user with uid and gid 1000. If you want to change them, create a custom image with following commands:

Dockerfile

FROM <IMAGE>:<TAG> # choose your base image

ARG USER_ID=1001210001
ARG GROUP_ID=2001210001
ENV USER_UID=${USER_ID}
ENV USER_GID=${GROUP_ID}

RUN apk add -U shadow \
    && usermod -u ${USER_ID} node \
    && groupmod -g ${GROUP_ID} node \
    && apk del -U shadow

When installing the agent add runAsUser and runAsGroup to helm values.customer.yml, not that strictSecurityContext must also be enabled to modify the uid and gid.

values.customer.yaml

...
strictSecurityContext: true
runAsUser: "1002810011"
runAsGroup: "1002810011"

Next steps

Extending deployment image - Build a custom Dockerfile from the agent base image.
Custom/optional configuration - Reference strictSecurityContext and security Helm values.
Self-hosted Kubernetes agent - Apply your custom image in the Helm install command.

​Next steps

Next steps