Como trocar a senha do Portainer no Z-PRO

O Portainer é o painel usado para gerenciar os containers Docker da sua instalação do Z-PRO (API, frontend, banco de dados, Redis, etc.)

Existem duas formas de trocar a senha: pela própria interface (quando você sabe a senha atual) ou pelo terminal do servidor (quando perdeu o acesso e precisa redefinir).

Pré-requisitos:

• Acesso ao painel do Portainer (geralmente em http://[seu_endereco]:9000) ou acesso ao terminal do servidor (SSH) com permissão para executar comandos docker. O link e credenciais de acesso do portainer são informados no terminal no final da instalação do Z-PRO, caso sua instalação tenha sido feita pela nossa equipe, essas credenciais se encontram no ticket de agendamento.

---

Opção 1: Trocar a senha pela interface (você sabe a senha atual)

1. Faça login no Portainer.

2. Clique no seu nome de usuário, no canto superior direito da tela.

3. Selecione "My account".

4. Preencha os três campos:

   • Current password (senha atual)

   • New password (nova senha)

   • Confirm password (confirme a nova senha)

5. Clique em "Update password".

O comprimento mínimo exigido para a nova senha é definido pelo administrador da instalação — se o Portainer recusar a senha, tente uma combinação mais longa.

---

Opção 2: Redefinir a senha pelo terminal (perdeu o acesso)

Use este método quando você não sabe a senha atual e não consegue entrar na interface.

1. Acesse o terminal do servidor via SSH.

2. Identifique o container do Portainer:

   docker ps

   Procure pela imagem portainer/portainer-ce (ou similar) e anote o nome do container — ex: portainer-x.

3. Pare o container do Portainer:

   docker stop [portainer-x]

4. Execute o helper de redefinição de senha:

   docker run --rm -v portainer_data:/data portainer/helper-reset-password

   • Ajuste o nome do volume (portainer_data) se a sua instalação usar outro nome.

   • Por padrão, o helper gera uma senha aleatória forte. Para definir você mesmo a nova senha, use:

     docker run --rm -v portainer_data:/data portainer/helper-reset-password --password "SuaNovaSenha"

5. Confira a saída do comando. Se for bem-sucedido, aparecerá algo como:

   2020/06/04 00:13:58 Password successfully updated for user: admin
   2020/06/04 00:13:58 Use the following password to login: Aqui_EstA_a_Senha

6. Reinicie o container do Portainer:

   docker start [portainer-x]

7. Acesse o Portainer novamente com o usuário admin e a nova senha exibida no passo 5.

Importante: se o helper não encontrar o usuário admin (ID 1) — por exemplo, se ele foi excluído —, um novo usuário será criado automaticamente com o nome admin-[texto-aleatório]. Confira a saída do comando com atenção.

---

Resumo das Funcionalidades

Funcionalidade	Onde acessar
Trocar senha sabendo a atual	Menu do usuário > My account (interface do Portainer)
Redefinir senha sem acesso	Terminal do servidor, container parado + portainer/helper-reset-password

---

Encerramento

Com a senha atualizada, você mantém o acesso seguro ao gerenciamento dos containers da sua instalação do Z-PRO. Guarde a nova senha em um local seguro — se for perdida novamente, o processo de redefinição pelo terminal exige parar o Portainer temporariamente.

---

Possíveis Erros e Soluções

"Invalid credentials" mesmo após redefinir a senha

Causa: o container do Portainer não foi reiniciado após o comando do helper, ou foi iniciado antes do helper terminar. Solução: confirme que o comando do passo 4 finalizou com a mensagem de sucesso antes de executar docker start.

Não sei o nome do volume de dados do Portainer

Causa: instalações diferentes podem nomear o volume de forma distinta. Solução: rode docker volume ls e procure por um volume com "portainer" no nome antes de executar o helper.