Skip to content

A container helper used to reset the administrator password of a Portainer instance

Notifications You must be signed in to change notification settings

portainer/helper-reset-password

Folders and files

NameName
Last commit message
Last commit date

Latest commit

f8b9091 · Apr 22, 2025

History

49 Commits
Jun 3, 2020
Dec 4, 2023
Aug 4, 2022
Jun 3, 2020
Jun 4, 2020
Aug 4, 2022
Mar 3, 2023
Aug 4, 2022
Apr 22, 2025
Aug 30, 2024
Jun 3, 2020

Repository files navigation

Portainer reset password helper

This helper container is designed to update the password of the original administrator account of a Portainer instance.

Note: it is designed to reset the password associated to the original administrator account (UserID == 1). If the account is removed, the helper will try to create a user named admin with UserID = 1. If the name admin is already taken, the helper will try to use "admin-" + a random string.

Usage

Portainer running as a container

# stop the existing Portainer container
docker container stop portainer

# run the helper using the same bind-mount/volume for the data volume
docker run --rm -v portainer_data:/data portainer/helper-reset-password
2020/06/04 00:13:58 Password succesfully updated for user: admin
2020/06/04 00:13:58 Use the following password to login: &_4#\3^5V8vLTd)E"NWiJBs26G*9HPl1

# restart portainer and use the password above to login
docker container start portainer

Portainer running as a stack/service

# scale down to zero the existing Portainer service
docker service scale portainer_portainer=0

# run the helper using the same bind-mount/volume for the data volume
docker run --rm -v portainer_portainer_data:/data portainer/helper-reset-password
2020/06/04 00:13:58 Password succesfully updated for user: admin
2020/06/04 00:13:58 Use the following password to login: &_4#\3^5V8vLTd)E"NWiJBs26G*9HPl1

# scale back to one the existing Portainer service and use the password above to login
docker service scale portainer_portainer=1

About

A container helper used to reset the administrator password of a Portainer instance

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published