VPS – Como alterar a porta padrão do PostgreSQL

O PostgreSQL utiliza a porta 5432 como padrão para receber conexões. Você pode alterar essa porta nas configurações do serviço, mas também precisará atualizar os dados de conexão dos sites e aplicativos que utilizam o banco. Neste artigo, mostramos como realizar essa alteração na sua VPS.

Se você deseja instalar o PostgreSQL mas ainda não sabe como fazer isso, nossa equipe preparou um artigo bem completo te mostrando passo a passo como fazer isso. Se quiser da uma olhada, é só acessá-lo clicando aqui.

Como alterar a porta do PostgreSQL no Ubuntu 24.04

Antes de começar, atualize a lista de pacotes:

sudo apt update && sudo apt upgrade -y

  1. Para conferir onde está o arquivo de configuração do PostgreSQL, execute:
    sudo -u postgres psql -p 5432 -c "SHOW config_file;"
    Consultando o nome do arquivo
    O resultado deve ser algo semelhante a: /etc/postgresql/16/main/postgresql.conf
    O 16 em negrito é a versão do PostgreSQL instalado. Se o resultado mostrar outro caminho, utilize-o nos próximos comandos.
  2. Neste artigo, utilizaremos a porta 55432. Antes de continuar, verifique se a porta que você deseja está disponível:
    sudo ss -ltnp 'sport = :55432'
    Consultando a disponibilidade da porta
    Se aparecer apenas o cabeçalho (como na imagem acima), nenhum serviço está vinculado nessa porta TCP naquele momento. Se houver um serviço listado, escolha uma outra porta.
  3. Para salvar uma cópia do arquivo de configuração antes de alterá-lo, execute:
    sudo cp -a /etc/postgresql/16/main/postgresql.conf /etc/postgresql/16/main/postgresql.conf.bak
    Criando cópia do arquivo
    Importante: Utilize o caminho obtido no passo 1.
  4. Abra o arquivo de configuração com o comando:
    sudo nano /etc/postgresql/16/main/postgresql.conf

    Caso o editor não esteja instalado, execute sudo apt install nano para instalar, e depois tente novamente.
  5. Desça um pouco no arquivo até encontrar a linha que define a porta. A linha deve estar port = 5432. Altere a porta “5432” para o valor que você deseja, em nosso exemplo, vamos usar a 55432.
    Alterando a porta padrão do PostgreSQL no arquivo de configuração dentro da VPS
    Se houver um # no início dessa linha, remova-o. Para salvar, pressione Ctrl + O, aperte a tecla Enter e depois saia pressionando Ctrl + X.
  6. Para aplicar a alteração, reinicie o PostgreSQL:
    sudo systemctl restart postgresql@16-main
  7. Confirme se o PostgreSQL está utilizando a nova porta:
    sudo ss -ltnp | grep postgres
    Resultado com a nova porta configurada
    O resultado deverá mostrar 55432.
  8. Nas configurações dos sites, aplicativos e ferramentas que utilizam esse banco, substitua a porta atual pela nova porta. Depois, teste o funcionamento de cada aplicação.

Comandos para outros sistemas

AlmaLinux 10:

# Atualiza os pacotes do sistema.
sudo dnf upgrade -y

# Instala o editor e a ferramenta de configuração do SELinux.
sudo dnf install -y nano policycoreutils-python-utils

# Mostra o caminho do arquivo de configuração.
sudo -u postgres psql -p 5432 -c "SHOW config_file;"

# Verifica se a porta 55432 está em uso. Se houver um serviço listado, escolha outra porta.
sudo ss -ltnp 'sport = :55432'

# Cria uma cópia da configuração. Se o caminho for diferente, ajuste no comando
sudo cp -a /var/lib/pgsql/data/postgresql.conf /var/lib/pgsql/data/postgresql.conf.bak

# Abre o arquivo de configuração.
sudo nano /var/lib/pgsql/data/postgresql.conf

# No editor, localize a configuração port e altere para a nova porta:
port = 55432
# Para salvar, pressione Ctrl + O, aperte a tecla Enter e depois saia pressionando Ctrl + X

# Verifica o estado do SELinux.
getenforce

# Se o resultado for Enforcing ou Permissive, consulte as portas autorizadas para o PostgreSQL.
sudo semanage port -l | grep postgresql_port_t

# Execute o comando abaixo somente se o SELinux estiver habilitado e a porta 55432 não 
# estiver na lista anterior. Se a porta já pertencer a outro tipo, escolha outra porta e
# ajuste também o arquivo de configuração.
sudo semanage port -a -t postgresql_port_t -p tcp 55432

# Reinicia o PostgreSQL para aplicar a alteração.
sudo systemctl restart postgresql

# Confirma a porta utilizada. O resultado esperado é a nova porta configurada.
sudo ss -ltnp | grep postgres

CentOS Stream 9:

# Atualiza os pacotes do sistema.
sudo dnf upgrade -y

# Instala o editor e a ferramenta de configuração do SELinux.
sudo dnf install -y nano policycoreutils-python-utils

# Mostra o caminho do arquivo de configuração.
sudo -u postgres psql -p 5432 -c "SHOW config_file;"

# Verifica se a porta 55432 está em uso. Se houver um serviço listado, escolha outra porta.
sudo ss -ltnp 'sport = :55432'

# Cria uma cópia da configuração. Se o caminho for diferente, ajuste no comando
sudo cp -a /var/lib/pgsql/data/postgresql.conf /var/lib/pgsql/data/postgresql.conf.bak

# Abre o arquivo de configuração.
sudo nano /var/lib/pgsql/data/postgresql.conf

# No editor, localize a configuração port e altere para a nova porta:
port = 55432
# Para salvar, pressione Ctrl + O, aperte a tecla Enter e depois saia pressionando Ctrl + X

# Verifica o estado do SELinux.
getenforce

# Se o resultado for Enforcing ou Permissive, consulte as portas autorizadas para o PostgreSQL.
sudo semanage port -l | grep postgresql_port_t

# Execute o comando abaixo somente se o SELinux estiver habilitado e a porta 55432 não 
# estiver na lista anterior. Se a porta já pertencer a outro tipo, escolha outra porta e
# ajuste também o arquivo de configuração.
sudo semanage port -a -t postgresql_port_t -p tcp 55432

# Reinicia o PostgreSQL para aplicar a alteração.
sudo systemctl restart postgresql

# Confirma a porta utilizada. O resultado esperado é nova porta configurada.
sudo ss -ltnp | grep postgres

Encontrou sua resposta?