Portainer Documentation
Official Website
Get 5 Nodes of BE Free
Search…
2.14
Welcome
What's new in version 2.14
Release Notes
Getting Started
Introduction
Portainer architecture
Requirements and prerequisites
Install Portainer
Upgrading Portainer
Using Portainer
Home
Docker/Swarm
Kubernetes
Azure ACI
Nomad
Edge Compute
Account settings
Administering Portainer
Users
Environments
Registries
Licenses
Authentication logs
Settings
Frequently Asked Questions
Portainer Concepts
Installing
Upgrading
Troubleshooting
Contributing
Advanced Topics
CLI configuration options
App templates
The Portainer Edge Agent
Access control
Reset the admin user's password
Security and compliance
Encrypting the Portainer database
Using your own SSL certificate with Portainer
Using Portainer with reverse proxies
Helm chart configuration options
Kubernetes roles and bindings
Deprecated and removed features
API
Accessing the Portainer API
API documentation
API usage examples
Get More Help
YouTube
Slack
Discord
Open a support request
Contribute to Portainer
Contribute
Build instructions
Powered By
GitBook
Reset the admin user's password
If your Portainer admin forgets their password, follow these steps to reset it. There are two methods depending on your Portainer environment.
Method 1: Resetting the admin password if Portainer runs as a container
You would typically use this method if you run the Portainer Server on Docker Standalone.
First, go to our
reset password container helper
in GitHub, then stop the Portainer container by running this command:
docker stop "id-portainer-container"
Next, run the helper using the following command (you'll need to mount the Portainer data volume):
docker run --rm -v portainer_data:/data portainer/helper-reset-password
If successful, the output should look like this:
2020/06/04 00:13:58 Password successfully updated for user: admin
2020/06/04 00:13:58 Use the following password to login: &_4#\3^5V8vLTd)E"NWiJBs26G*9HPl1
Finally, use this command to start the Portainer container then try logging in with the new password:
docker start "id-portainer-container"
Method 2: Resetting the admin password if Portainer runs as a stack/service
You would typically use this method if you run the Portainer Server on Docker Swarm.
First, scale the Portainer service to zero using this command:
docker service scale portainer_portainer=0
Next, run the
reset password container helper
using the same bind-mount/volume as the data volume:
docker run --rm -v portainer_portainer_data:/data portainer/helper-reset-password
If successful, the output should look like this:
2020/06/04 00:13:58 Password successfully updated for user: admin
2020/06/04 00:13:58 Use the following password to login: &_4#\3^5V8vLTd)E"NWiJBs26G*9HPl1
Finally, start up the Portainer service scaling using this command then try logging in with the new password:
docker service scale portainer_portainer=1
Advanced Topics - Previous
Access control
Next - Advanced Topics
Security and compliance
Last modified
1mo ago
Copy link
Edit on GitHub
Outline
Method 1: Resetting the admin password if Portainer runs as a container
Method 2: Resetting the admin password if Portainer runs as a stack/service