Variáveis de ambiente do Portainer
87 variáveis em 10 categorias
As categorias com mais variáveis têm página própria. As menores aparecem completas no fim desta página. Cada variável traz tipo, valor padrão, valores aceitos, situação e o link para a fonte oficial.A lista sai da documentação e do código do Portainer, conferidos em 13 de novembro de 2026.
- Versão de referência
- 2.45.3
- AWS IAM Roles Anywhere
AWS_CLIENT_BUNDLEAWS_CLIENT_CERTAWS_CLIENT_KEY
- Banco de dados local
--data
- Edge Compute
--edge-tunnel-server-addressEDGE_ASYNCEDGE_COMPUTE
- Logs
--log-level--log-modeLOG_LEVEL
- Portainer Agent
AGENT_CLUSTER_ADDRAGENT_CLUSTER_PROBE_INTERVALAGENT_CLUSTER_PROBE_TIMEOUT
- Portainer Server
--hide-label--http-disabled--http-enabled
- Proxy de saída
HTTP_PROXYHTTPS_PROXY
- Rede e proxy reverso
--base-url--bind--bind-https
- Segurança e autenticação
--admin-password--admin-password-file--trusted-proxies
- TLS e certificados
--mtlscacert--mtlscert--mtlskey
AWS IAM Roles Anywhere
Arquivo do bundle de certificados intermediários x509 usado na autenticação com o IAM Roles Anywhere.
Equivale à flag --aws-bundle.
- Tipo
- Texto
- Padrão
- sem padrão
Arquivo do certificado x509 usado na autenticação com o IAM Roles Anywhere.
Equivale à flag --aws-cert.
- Tipo
- Texto
- Padrão
/certs/aws-client.crt
Arquivo da chave privada usada na autenticação com o IAM Roles Anywhere.
Equivale à flag --aws-key.
- Tipo
- Texto
- Padrão
/certs/aws-client.key
ARN do profile da AWS de onde o agent obtém as políticas na autenticação com o IAM Roles Anywhere.
Equivale à flag --aws-profile-arn.
- Tipo
- Texto
- Padrão
- sem padrão
Região da AWS usada na assinatura com o IAM Roles Anywhere.
Equivale à flag --aws-region.
- Tipo
- Texto
- Padrão
- sem padrão
ARN do role da AWS que o agent assume na autenticação com o IAM Roles Anywhere.
Equivale à flag --aws-role-arn.
- Tipo
- Texto
- Padrão
- sem padrão
ARN do trust anchor do IAM usado na autenticação com o IAM Roles Anywhere.
Equivale à flag --aws-trust-anchor-arn.
- Tipo
- Texto
- Padrão
- sem padrão
Banco de dados local
Diretório onde o Portainer grava os dados. O padrão é
/datano Linux eC:\datano Windows.Flag de linha de comando. Não é variável de ambiente.
- Tipo
- Texto
- Padrão
/data on Linux, C:\data on Windows
Logs
Nível dos logs do Portainer, como
DEBUG, útil para diagnosticar problemas. O log de depuração também pode ser ativado em Settings.Flag de linha de comando. Não é variável de ambiente.
- Tipo
- Enum
- Padrão
INFO- Valores
DEBUGINFOWARNERROR
Formato da saída de log:
PRETTY, o padrão,NOCOLOR, sem códigos de cor, ouJSON.Flag de linha de comando. Não é variável de ambiente.
- Tipo
- Enum
- Padrão
PRETTY- Valores
NOCOLORPRETTYJSON
Nível de detalhe dos logs:
ERROR,WARN,INFOouDEBUG. O padrão éINFO.Equivale à flag --log-level.
- Tipo
- Enum
- Padrão
INFO- Valores
ERRORWARNINFODEBUG
Formato da saída de log: NOCOLOR, PRETTY ou JSON.
Equivale à flag --log-mode.
- Tipo
- Enum
- Padrão
PRETTY- Valores
NOCOLORPRETTYJSON
Portainer Server
Oculta na interface os containers que têm a label informada.
Flag de linha de comando. Não é variável de ambiente.
- Tipo
- Texto
- Padrão
- sem padrão
Serve o Portainer apenas por HTTPS e prevalece sobre
--http-enabled. Antes de ativar, confirme que a configuração de HTTPS funciona e que os agents usam HTTPS.Flag de linha de comando. Não é variável de ambiente.
- Tipo
- Booleano
- Padrão
false
Serve o Portainer por HTTP. O Portainer ignora esta opção quando
--http-disabledestá ativa.Flag de linha de comando. Não é variável de ambiente.
- Tipo
- Booleano
- Padrão
false
Chave de licença do Portainer Business Edition.
Flag de linha de comando. Não é variável de ambiente.
- Tipo
- Segredo
- Padrão
- sem padrão
URL da imagem exibida como logo na interface. Sem valor, a interface usa o logo do Portainer.
Flag de linha de comando. Não é variável de ambiente.
- Tipo
- URL
- Padrão
- sem padrão
Ativa o modo Edge, que vem desativado. Use
1outruepara ativar.Equivale à flag --edge.
- Tipo
- Booleano
- Padrão
- sem padrão
Dispensa o setup token na inicialização e na restauração de uma instância ainda não configurada.
Equivale à flag --no-setup-token.
- Tipo
- Booleano
- Padrão
- sem padrão
Define um setup token próprio na inicialização e na restauração de uma instância ainda não configurada, no lugar do token gerado automaticamente.
Equivale à flag --setup-token.
- Tipo
- Segredo
- Padrão
- sem padrão
Proxy de saída
Proxy HTTP usado pelo agent para abrir túneis por websocket.
Equivale à flag --edge-tunnel-http-proxy.
- Tipo
- Texto
- Padrão
- sem padrão
Proxy HTTPS usado pelo agent para abrir túneis por websocket.
Equivale à flag --edge-tunnel-https-proxy.
- Tipo
- Texto
- Padrão
- sem padrão
Rede e proxy reverso
Subcaminho onde o Portainer roda atrás de um proxy reverso, como
/portainer. O padrão é/. A configuração do proxy precisa remover esse prefixo das requisições.Flag de linha de comando. Não é variável de ambiente.
- Tipo
- Texto
- Padrão
/
Endereço e porta onde o Portainer atende. O padrão é
:9000.Flag de linha de comando. Não é variável de ambiente.
- Tipo
- Texto
- Padrão
:9000
Endereço e porta onde o Portainer atende por HTTPS. O padrão é
:9443.Flag de linha de comando. Não é variável de ambiente.
- Tipo
- Texto
- Padrão
:9443
Define o endpoint do daemon Docker ao qual o Portainer se conecta. Este parâmetro é uma flag de linha de comando.
Flag de linha de comando. Não é variável de ambiente.
- Tipo
- Texto
- Padrão
- sem padrão
Intervalo entre os jobs de snapshot do ambiente, como
30s,5mou1h. O padrão é5m.Flag de linha de comando. Não é variável de ambiente.
- Tipo
- Texto
- Padrão
5m
URL das definições de templates de aplicações.
Flag de linha de comando. Não é variável de ambiente.
- Tipo
- URL
- Padrão
- sem padrão
Endereço de escuta do servidor de túnel usado pelo Edge Agent. O padrão é
0.0.0.0, em todas as interfaces.Flag de linha de comando. Não é variável de ambiente.
- Tipo
- Texto
- Padrão
0.0.0.0
Porta alternativa do servidor de túnel do Edge Agent. Use com a publicação correspondente, como
-p 8001:8001.Flag de linha de comando. Não é variável de ambiente.
- Tipo
- Texto
- Padrão
8000
Seleciona a imagem de container usada pelo Portainer para abrir o shell do kubectl.
Equivale à flag --kubectl-shell-image.
- Tipo
- Texto
- Padrão
- sem padrão
Segurança e autenticação
Hash bcrypt da senha do usuário admin. O valor só tem efeito na criação do admin, durante a instalação. Depois disso, ele não troca a senha.
Flag de linha de comando. Não é variável de ambiente.
- Tipo
- Segredo
- Padrão
- sem padrão
Arquivo com a senha em texto puro do usuário admin. O valor só tem efeito na criação do admin, durante a instalação. Depois disso, ele não troca a senha.
Flag de linha de comando. Não é variável de ambiente.
- Tipo
- Texto
- Padrão
- sem padrão
IPs ou CIDRs dos proxies de encaminhamento à frente do Portainer, separados por vírgula. O Portainer só confia nos cabeçalhos
X-Forwarded-ForouForwardedvindos desses proxies para registrar o IP do cliente no campo Origin dos logs de autenticação.Flag de linha de comando. Não é variável de ambiente.
- Tipo
- Texto
- Padrão
- sem padrão
Compacta o banco do Portainer na inicialização.
Equivale à flag --compact-db.
- Tipo
- Booleano
- Padrão
false
Permite requisições autenticadas por cookie sem Origin ou Sec-Fetch-Site, o que desativa a proteção CSRF nesses casos.
- Tipo
- Booleano
- Padrão
false
Lista de feature flags habilitadas na inicialização.
Equivale à flag --feat.
- Tipo
- Lista
- Padrão
- sem padrão
Feature flags habilitadas na inicialização, separadas por vírgula.
- Tipo
- Lista
- Padrão
- sem padrão
Origens confiáveis para a proteção CSRF, separadas por vírgula.
Equivale à flag --trusted-origins.
- Tipo
- Texto
- Padrão
- sem padrão
Uma VPS para desenvolver com agentes
Servidor da StayCloud em São Paulo, com acesso root e disco NVMe, para deixar seus agentes de IA rodando o dia todo.
Link de parceiro da Promovaweb.