If you use Docker Desktop on Windows, you may run into a permission error that says you must be added to the docker-users group. This group controls who is allowed to interact with Docker’s backend services. If your account isn’t part of it, Docker Desktop may fail to start or block commands like pulling images, running containers, or building projects.
The good news is that adding yourself to the docker-users group is simple—and you can do it through Windows Settings, Local Users and Groups, or even PowerShell. In this guide, we’ll walk you through every reliable method so you can get Docker up and running on your Windows machine in minutes.
How to Add Yourself to the docker-users Group on Windows
Here are the best ways to add your user to the docker-users group.
1. Add Yourself Using Computer Management
This is the easiest and most common method.
- Press Windows + X and select Computer Management.
- In the left panel, expand Local Users and Groups.
- Click Groups.
- In the right panel, double-click docker-users.
- Click Add.
- Type your Windows username and click Check Names.
- Click OK, then Apply.
Once added, log out and log back in for the change to take effect.
2. Add Yourself via Windows Settings (Windows 11 Pro/Enterprise)
If your system includes Local User Group Management through Settings, you can use this built-in method.
- Open Settings.
- Go to System > For Developers.
- Scroll down and select Manage users in Local Groups.
- Find docker-users in the list.
- Click Add user.
- Enter your username and confirm.
Restart your computer to apply group membership updates.
3. Add Your User with PowerShell (Fastest Method)
PowerShell is a quick way to add yourself without navigating menus.
Open PowerShell as Administrator:
- Click Start, type PowerShell, and select Run as administrator.
Run the command:
Add-LocalGroupMember -Group "docker-users" -Member "$env:USERNAME"
You can also add other users by replacing "$env:USERNAME" with their name.
Restart your session for the change to take effect.
4. Add Yourself Using Command Prompt
Command Prompt offers a classic alternative using the net localgroup command.
Open CMD as Administrator:
- Press Start, type cmd, right-click Command Prompt, and choose Run as administrator.
Run the command:
net localgroup docker-users "%USERNAME%" /add
If the command returns “The command completed successfully,” you’re in the group.
5. Verify That You’ve Been Added
To confirm everything worked, check your membership.
Using PowerShell:
Get-LocalGroupMember -Group "docker-users"
Using Computer Management:
- Go to Local Users and Groups.
- Open Groups.
- Double-click docker-users.
- Look for your username in the list.
If your user appears there, you’re all set.
6. Restart Docker Desktop
Group membership changes don’t take effect until you restart your session.
- Log out and log back in, or restart your PC.
- Launch Docker Desktop.
Docker should now start without permission errors.
Wrapping Up
Adding yourself to the docker-users group is essential for working with Docker Desktop on Windows, and fortunately, it only takes a minute. Whether you prefer using Computer Management, PowerShell, or the command line, all methods achieve the same result—giving your account permission to interact with Docker’s engine.
Once you’re added, restart Docker Desktop and you’ll be ready to pull images, run containers, manage volumes, and build apps without running into permission issues. If you want, I can also write a related guide on installing Docker Desktop or fixing common Docker Engine startup errors.