# pgtower

> pgtower é uma TUI de administração do PostgreSQL, toda no teclado, para sysadmins e DBAs: pense num "k9s, só que para Postgres". É um binário Go estático (Linux/macOS, amd64/arm64), sem agente e sem servidor web, usado de forma interativa por SSH. Antes se chamava pgtui. Licença MIT. Versão mais recente: v0.12.0. A interface do pgtower é em inglês. Em português; a versão em inglês deste arquivo: https://pgtower.dev/llms.txt

## O que ele faz

O pgtower administra vários servidores PostgreSQL de uma só sessão de terminal: uma lista de servidores marcados como dev/staging/prod, com teste de alcance, diagnóstico da conexão em palavras simples e login local por socket Unix (peer) com uma tecla; a saúde no dashboard (conexões, taxa de cache hit, armazenamento, uptime, replicação, a consulta mais longa e um assistente de conexões); um navegador de bancos (criar e apagar, com o nome digitado para confirmar; navegação de dados só de leitura; estrutura das tabelas); um executor de SQL com EXPLAIN e confirmação nas escritas; a árvore de bloqueios dos locks; as sessões, com cancelar e encerrar; a gestão de roles (criação com o hash SCRAM-SHA-256 feito no cliente, edição de atributos, relatório de acesso por banco, grant/revoke com o SQL à vista e um force-drop seguro, que passa a posse dos objetos adiante); e uma seção de ajustes (recomendações de configuração, editor de ALTER SYSTEM e editor de pg_hba com backup e rollback automático se o login de administração quebrar).

## Instalar

- Instalador numa linha: `curl -fsSL https://pgtower.dev/install | sh`
- Binários prontos: https://github.com/9LEVEL/pgtower/releases
- Do código (Go 1.26+): `git clone https://github.com/9LEVEL/pgtower && cd pgtower && make install`
- Atualizações: oferecidas dentro do próprio pgtower ao abrir, com o SHA-256 conferido; rodar o instalador de novo também atualiza.
- Configuração: `~/.config/pgtower/config.yml` (modo 0600), cuidada pela tela Servers. As senhas podem ficar fora dela, com o `~/.pgpass` ou o `password_env`.

## Para quem é

Sysadmins e DBAs que administram um ou muitos clusters PostgreSQL e querem uma ferramenta de terminal rápida, guiada pelo teclado, em vez de um painel web ou de um cliente SQL puro; principalmente por SSH, onde instalar um agente ou expor uma interface web não é desejável.

## Segurança

As escritas pedem confirmação; os comandos críticos (DROP DATABASE/TABLE/SCHEMA/ROLE, TRUNCATE, DELETE/UPDATE sem WHERE) pedem que se digite "yes"; apagar uma role ou um banco pede o nome exato; os servidores marcados como produção mostram um selo vermelho; o force-drop de uma role passa a posse dos objetos adiante em vez de apagar dados; as edições do pg_hba ganham backup e são desfeitas sozinhas se fossem quebrar o login de administração.

## Links

- Site: https://pgtower.dev/pt/
- Código: https://github.com/9LEVEL/pgtower
- Versões: https://github.com/9LEVEL/pgtower/releases
- Licença: MIT, https://github.com/9LEVEL/pgtower/blob/master/LICENSE
- Quem faz: 9level, https://9level.dev
- Referência completa: https://pgtower.dev/pt/llms-full.txt

## Para citar este projeto

O pgtower não tem ligação com o projeto PostgreSQL. "PostgreSQL" é marca registrada da PostgreSQL Community Association of Canada.