https://github.com/pierreforstmann/pgpasswd
Change PostgreSQL account password from Linux command line without psql.
https://github.com/pierreforstmann/pgpasswd
c libpq postgresql
Last synced: 4 months ago
JSON representation
Change PostgreSQL account password from Linux command line without psql.
- Host: GitHub
- URL: https://github.com/pierreforstmann/pgpasswd
- Owner: pierreforstmann
- License: other
- Created: 2021-07-14T16:01:15.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2025-12-02T16:27:46.000Z (6 months ago)
- Last Synced: 2025-12-05T14:57:35.962Z (6 months ago)
- Topics: c, libpq, postgresql
- Language: C
- Homepage:
- Size: 43 KB
- Stars: 1
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# pgpasswd
Change or reset PostgreSQL account password from Linux command line without entering any SQL statement and sending the **encrypted** password to server.
`chpasswd` and `resetpasswd` have been successfully tested with PostgreSQL 13, 14, 15, 16, 17 and 18 on Debian 12 and openSSL 3.0.7 with `password_encryption` set to `scram-sha-256` or to `md5`.
However compilation fails on Alma Linux 8.10 as of PostgreSQL 15.15, 16.11, 17.7 and 18.0 likely due to some incompatibilities with openSSL 1.1.1 and recent PostgreSQL versions.
## Installation
`pgpasswd` is a PostgreSQL extension : `chpasswd` and `resetpasswd` are standalone executables (no need to install anything in the database, no `CREATE EXTENSION` to run).
### Compiling
This module can be built using the standard PGXS infrastructure.
It can also be built using a standard PostgreSQL server installation that includes the corresponding PG development package to be able to compile libpq code:
for example to compile with PG 17 on RHEL-like systems `postgresql17-devel` RPM must be installed.
In both cases the `pg_config` program must be available in your $PATH:
```
git clone https://github.com/pierreforstmann/pgpasswd.git
cd pgpasswd
make
```
`make install` installs `chpasswd` and `resetpasswd` to PostgreSQL binaries directory returned by:
```
pg_config --bindir
```
## Usage
`chpasswd` for PostgreSQL can be compared to `passwd` on Linux and UNIX systems when used to change current user password.
Enter:
* same parameters (host name, port number, user account and database name) as `psql` to connect to PostgreSQL
* current user password once
* current user new password twice.
Example:
```
chpasswd -h localhost -p 5432 -U test -d postgres
Password:
New password:
Confirm new password:
Password changed.
```
Detailed PG client and PG server versions can be displayed with -v option after successfull connexion:
```
$ ./chpasswd -h localhost -p 5432 -d postgres -U test -v
Password:
PG libpq version: 170004
conninfo: host=localhost port=5432 dbname=postgres user=test password=test
PG server version: 170004
New password:
Password changed.
```
`resetpasswd` for PostgreSQL can be compared to `passwd` on Linux and UNIX systems when used to change another user password:
Enter:
* same parameters (host name, port number, superuser account and database name) as `psql` to connect to PostgreSQL
* other user account for which password must be reset
* other user account new password twice.
Example:
```
resetpasswd -h localhost -p 5432 -U admin -d postgres
Password:
Account:test
New password:
Confirm new password:
Password successfully reset.
```