Version 1.0.0
Language EN

User Registration

Drone registration is open by default. This means any user can create a Drone account and use the system. This article describes how to lock down the system and limit registration to authorized accounts.


You can limit registration by passing the DRONE_USER_FILTER environment variable to your Drone server. This variable provides a comma-separated lists of user and organizations accounts that are permitted to register.

Example configuration limits access to a named list of users:

DRONE_USER_FILTER=octocat,spaceghost

Example configuration limits access to individuals that are members of named organizations (e.g. github organization). In the below example, only users that are members of the google and kubernetes organizations can create Drone accounts.

DRONE_USER_FILTER=google,kubernetes

Example configuration combines user and organization limits:

DRONE_USER_FILTER=octocat,spaceghost,google,kubernetes

On This Page:

Getting Help

Mailing List
Search for information in the mailing list archives, or post a question.
Chat Support
Real-time chat support from maintainers and community members.