> For the complete documentation index, see [llms.txt](https://ajuda.zdg.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.zdg.com.br/avancado-recursos-tecnicos/infraestrutura/como-trocar-a-senha-do-portainer-no-z-pro.md).

# Como trocar a senha do Portainer no Z-PRO

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).

{% hint style="info" %}
**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.
  {% endhint %}

***

### 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"**.

{% hint style="warning" %}
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.
{% endhint %}

***

### 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.

{% hint style="danger" %}
**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.
{% endhint %}

***

### 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.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ajuda.zdg.com.br/avancado-recursos-tecnicos/infraestrutura/como-trocar-a-senha-do-portainer-no-z-pro.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.