Variáveis de ambiente do Uptime Kuma
28 variáveis em 4 categorias
Todas as variáveis estão nesta página, agrupadas por categoria, com tipo, valor padrão, valores aceitos, situação e fonte oficial.A lista sai da documentação e do código do Uptime Kuma, conferidos em 12 de novembro de 2026.
- Versão de referência
- 2.5.11
Banco de dados MariaDB
Conteúdo do certificado CA em PEM, usado para validar a conexão TLS com o MariaDB.
- Tipo
- Texto
- Padrão
- sem padrão
Caminho de um arquivo com o valor de UPTIME_KUMA_DB_CA, para usar Docker secrets.
- Tipo
- Texto
- Padrão
- sem padrão
Host do servidor MariaDB usado quando UPTIME_KUMA_DB_TYPE é mariadb.
- Tipo
- Texto
- Padrão
- sem padrão
Nome do banco de dados MariaDB usado pelo Uptime Kuma.
- Tipo
- Texto
- Padrão
- sem padrão
Senha do usuário de conexão com o banco MariaDB.
- Tipo
- Segredo
- Padrão
- sem padrão
Caminho de um arquivo com o valor de UPTIME_KUMA_DB_PASSWORD, para usar Docker secrets.
- Tipo
- Segredo
- Padrão
- sem padrão
Número máximo de conexões simultâneas no pool do banco. O padrão é 10.
- Tipo
- Número
- Padrão
- sem padrão
Porta do servidor MariaDB. O valor usual é 3306.
- Tipo
- Número
- Padrão
- sem padrão
Caminho do socket Unix do MariaDB. Quando definido, host e porta são ignorados.
- Tipo
- Texto
- Padrão
- sem padrão
Definir como true habilita TLS na conexão com o MariaDB. O padrão é false.
- Tipo
- Booleano
- Padrão
- sem padrão
Tipo de banco usado pelo Uptime Kuma. Aceita sqlite, o padrão, ou mariadb.
- Tipo
- Enum
- Padrão
- sem padrão
- Valores
sqlitemariadb
Define o usuário usado pelo Uptime Kuma para autenticar a conexão com o banco MariaDB.
- Tipo
- Texto
- Padrão
- sem padrão
Caminho de um arquivo com o valor de UPTIME_KUMA_DB_USERNAME, para usar Docker secrets.
- Tipo
- Texto
- Padrão
- sem padrão
Notificações
Proxy usado no envio de notificações, informado como URL completa. Aceita os esquemas http, https, socks, socks4, socks5 e socks5h.
- Tipo
- URL
- Padrão
- sem padrão
Runtime Node.js
Caminho de um certificado CA em PEM para confiar em autoridades próprias ao monitorar serviços com certificado autoassinado.
- Tipo
- Texto
- Padrão
- sem padrão
Opções extras do Node.js. A wiki cita --insecure-http-parser para contornar o erro Invalid header value char em sites atrás de WAF.
- Tipo
- Texto
- Padrão
- sem padrão
Definir como 0 faz o Node.js ignorar erros de certificado TLS em todas as conexões do processo.
- Tipo
- Texto
- Padrão
0
Servidor e interface
Diretório onde o Uptime Kuma grava dados, banco SQLite e anexos. O padrão é ./data/, que na imagem oficial corresponde ao volume em /app/data.
- Tipo
- Texto
- Padrão
./data/
Definir como 1 permite apontar qualquer executável como Chromium nos monitores que usam navegador.
- Tipo
- Booleano
- Padrão
0
Token do Cloudflare Tunnel usado para publicar o painel sem abrir portas no host.
- Tipo
- Segredo
- Padrão
- sem padrão
Definir como true libera o painel em iframe de outro domínio. Sem isso, a proteção contra uso do Uptime Kuma em páginas de phishing fica ativa.
- Tipo
- Booleano
- Padrão
false
Endereço de escuta do servidor. Aceita IP ou nome de host e também o nome HOST.
- Tipo
- Texto
- Padrão
::
Porta HTTP do servidor. O padrão é 3001 e também pode ser definido pela variável PORT.
- Tipo
- Número
- Padrão
3001
Manter true usa uma única conexão com o SQLite. Definir false libera conexões simultâneas, com possibilidade de erro SQLITE_BUSY: database is locked.
- Tipo
- Booleano
- Padrão
true
Caminho do arquivo do certificado TLS usado para servir o painel em HTTPS. Também aceita o nome SSL_CERT.
- Tipo
- Texto
- Padrão
- sem padrão
Caminho do arquivo da chave privada TLS usada para servir o painel em HTTPS. Também aceita o nome SSL_KEY.
- Tipo
- Texto
- Padrão
- sem padrão
Senha da chave privada TLS, quando o arquivo estiver protegido. Também aceita o nome SSL_KEY_PASSPHRASE.
- Tipo
- Segredo
- Padrão
- sem padrão
Controla a checagem do cabeçalho ORIGIN das conexões WebSocket. O padrão é cors-like. Definir bypass desativa a verificação.
- Tipo
- Texto
- Padrão
cors-like
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.