1213

I'm getting the error:

FATAL: Peer authentication failed for user "postgres"

when I try to make postgres work with Rails.

Here's my pg_hba.conf, my database.yml, and a dump of the full trace.

I changed authentication to md5 in pg_hba and tried different things, but none seem to work.

I also tried creating a new user and database as per Rails 3.2, FATAL: Peer authentication failed for user (PG::Error)

But they don't show up on pgadmin or even when I run sudo -u postgres psql -l.

Any idea where I'm going wrong?

7
  • 1
    1): Make sure you have a user named "postgres" created and having right on your Database 2): Make sure he has a password 3): Make sure your config/database.yml contains the rights credentials (username + password)
    – MrYoshiji
    Commented Sep 6, 2013 at 18:19
  • 2
    need everyplace peer and indent set to md5 Commented Jul 28, 2015 at 8:55
  • 41
    See also this answer - connection may fail on localhost but succeed on 127.0.0.1.
    – uvsmtid
    Commented Aug 26, 2015 at 7:13
  • 15
    In my case I needed to add host: localhost in the database.yml file. Commented Mar 16, 2016 at 6:50
  • 6
    I fixed this error by appending --host=localhost which I assumed to be the default
    – Collin
    Commented Sep 5, 2019 at 22:20

28 Answers 28

1552

The problem is still your pg_hba.conf file*.

This line:

local   all             postgres                                peer

Should be:

local   all             postgres                                md5

After altering this file, don't forget to restart your PostgreSQL server. If you're on Linux, that would be sudo systemctl restart postgresql (on older systems: sudo service postgresql restart).


Locating hba.conf

Note that the location of this file isn't very consistent.

You can use locate pg_hba.conf or ask PostgreSQL SHOW hba_file; to discover the file location.

Usual locations are /etc/postgresql/[version]/main/pg_hba.conf and /var/lib/pgsql/data/pg_hba.conf.


These are brief descriptions of the peer vs md5 options according to the official PostgreSQL docs on authentication methods.

Peer authentication

The peer authentication method works by obtaining the client's operating system user name from the kernel and using it as the allowed database user name (with optional user name mapping). This method is only supported on local connections.

Password authentication

The password-based authentication methods are md5 and password. These methods operate similarly except for the way that the password is sent across the connection, namely MD5-hashed and clear-text respectively.

If you are at all concerned about password "sniffing" attacks then md5 is preferred. Plain password should always be avoided if possible. However, md5 cannot be used with the db_user_namespace feature. If the connection is protected by SSL encryption then password can be used safely (though SSL certificate authentication might be a better choice if one is depending on using SSL).

24
  • 77
    You'll need to reload your postgresql service after changing this /etc/init.d/postgresql reload
    – funkotron
    Commented Oct 28, 2013 at 13:50
  • 93
    putting this here since I always forget where this file is /etc/postgresql/9.1/main/pg_hba.conf
    – Doug
    Commented Jan 30, 2014 at 21:08
  • 17
    @funkotron At least on my ElementaryOS (Ubuntu) installation, sudo service postgreql restart also works. Commented Mar 21, 2014 at 17:47
  • 19
    To answer my own question: 'peer' authentication means that postgres asks the operating system for your login name and uses this for authentication, so the user on the OS and on postgres must be the same. 'md5' uses encrypted password authentication.
    – Dennis
    Commented Mar 28, 2014 at 15:17
  • 13
    I understand the change. But why isn't this the default behaviour? Is there any drawback using md5? Commented Jun 13, 2015 at 19:31
683

After installing Postgresql I did the below steps.

  1. Open the file pg_hba.conf. For Ubuntu, use for example /etc/postgresql/13/main$ sudo nano pg_hba.conf and change this line at the bottom of the file, it should be the first line of the settings:

    local   all             postgres                                peer

    to

    local   all             postgres                                trust

    Side note: If you want to be able to connect with other users as well, you also need to change:

    local   all             all                                peer

    to

    local   all             all                                md5

    If you used nano editor, exit with double Escape, x, y, Enter to save the config file.

  2. Restart the server

     $ sudo service postgresql restart
    

    Output: * Restarting PostgreSQL 13 database server

  3. Login into psql and set your password

     $ psql -U postgres
     db> ALTER USER postgres with password 'your-pass';
    

    Output: ALTER ROLE

    Side note: If you have other users, they will need a password as well:

     db> ALTER USER my_user with password 'your-pass';
    

    Then enter:

     exit
    
  4. Finally change the pg_hba.conf from

    local   all             postgres                                trust

    to

    local   all             postgres                                md5
  5. Restart the server again

     $ sudo service postgresql restart
    

    Output: * Restarting PostgreSQL 13 database server

  6. Login at psql with postgres user

    After restarting the postgresql server, the postgres user accepts the password that you chose:

     psql -U postgres
    

    Output:
    Password for user postgres:

    psql (13.4 (Ubuntu 13.4-1.pgdg20.04+1))

    Type "help" for help.

    And you are in psql:

    postgres=#

    Side note: Same now works for my_user if you added the user and password:

     psql -d YOUR_DB_NAME -U my_user
    

    Which will ask you for the new password of my_user.

Authentication methods details:

trust - anyone who can connect to the server is authorized to access the database

peer - use client's operating system user name as database user name to access it.

md5 - password-base authentication

for further reference check here

13
  • 36
    changing the method to "trust" worked for me. +1 for explanation of authentication method details. Commented Nov 18, 2014 at 22:46
  • 8
    On OS X homebrew the default is trust, while on Ubuntu somehow the default is set to "peer", which led to discrepancies between my setup and that of my colleague. We changed his to MD5 which didn't help, so "trust" is the real answer here(We're only doing development testing). Should get more upvotes.
    – xji
    Commented Nov 22, 2014 at 14:42
  • 2
    you also can set md5 everyplace from the very beginning Commented Jul 28, 2015 at 8:50
  • 2
    This way is working for me, using method md5 first was not.
    – anipard
    Commented Sep 16, 2016 at 22:39
  • need to use same passwords? sudo passwd postgres Commented Aug 27, 2017 at 15:52
352

If you connect over localhost (127.0.0.1) you shouldn't experience that particular issue. I wouldn't muck much with the pg_hba.conf but instead I would adjust your connection string:

psql -U someuser -h 127.0.0.1 database

where someuser is your user you're connecting as and database is the database your user has permission to connect to.

Here is what I do on Debian to setup postgres:

http://www.postgresql.org/download/linux/debian/  (Wheezy 7.x)

as root …

    root@www0:~# echo "deb http://apt.postgresql.org/pub/repos/apt/ wheezy-pgdg main" >> /etc/apt/sources.list

    root@www0:~# wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | apt-key add -

    root@www0:~# apt-get update

    root@www0:~# apt-get install postgresql-9.4        

    root@www0:~# su - postgres 

    postgres@www0:~$ createuser --interactive -P someuser
    Enter password for new role:
    Enter it again:
    Shall the new role be a superuser? (y/n) n
    Shall the new role be allowed to create databases? (y/n) y
    Shall the new role be allowed to create more new roles? (y/n) n

    postgres@www0:~$ createdb -O someuser database

    postgres@www0:~$ psql -U someuser -h 127.0.0.1 database

Enjoy!

9
  • 43
    I think this is the best solution as it actually solves the local problem without messing without messing with global configuration as the other answers recommend.
    – jeteon
    Commented Jan 31, 2016 at 4:47
  • 3
    I had to change host: 127.0.0.1 from defaulting to localhost in config/database.yml - it's on the same machine so I don't understand why
    – Anthony
    Commented Jan 26, 2017 at 22:21
  • Anthony, are you saying you experienced a connection failure until you adjusted localhost to 127.0.0.1 in your database.yml? I suggest checking your /etc/hosts file if that's the case. Otherwise, there might be some other oddity related to resolving localhost. Commented Jan 29, 2017 at 16:41
  • 6
    This is much more elegant when compared to messing with the local peer authentication method.
    – mdh
    Commented Feb 25, 2017 at 14:18
  • 2
    This just hits me again, thinking of beeing on localhost ist not the same as telling this to psql. The real problem ist, that at least on *nix OSs psql otherwise will try to connect via local socket, which is by default only allowed for the user postgres.
    – normic
    Commented Jan 20, 2019 at 23:21
108

This has worked for me !!

sudo -u postgres psql
1
  • 4
    this should work fine as long as your current logged in user is in sudoers file. Commented Nov 1, 2018 at 14:24
42
sudo psql --host=localhost --dbname=database-name --username=postgres

This solved my issue

1
  • 4
    I didnt think it would be that simple, but this worked for me under debian 9 Commented Jul 11, 2019 at 0:47
25

If you have an issue, you need to locate your pg_hba.conf. The command is:

find / -name 'pg_hba.conf' 2>/dev/null

and after that change the configuration file:

Postgresql 9.3

Postgresql 9.3

Postgresql 9.4

Postgresql 9.3

The next step is: Restarting your db instance:

service postgresql-9.3 restart

If you have any problems, you need to set password again:

ALTER USER db_user with password 'db_password';

1
  • 1
    thank you for the find command! using the fedoara file explorer never returned pg_hba.conf in any searches. now i can finally update that file
    – JesseBoyd
    Commented Feb 6, 2023 at 2:19
25

Simplest solution without changing configs. (ubuntu) Change user, then connect to database cli.

sudo -i -u postgres

psql

taken from https://www.digitalocean.com/community/tutorials/how-to-install-and-use-postgresql-on-ubuntu-18-04

0
23
  1. Go to this /etc/postgresql/9.x/main/ and open pg_hba.conf file

In my case:

$>  sudo nano /etc/postgresql/9.3/main/pg_hba.conf
  1. Replace peer with md5

So this will be changed to:

Database administrative login by Unix domain socket local all postgres peer

# TYPE  DATABASE        USER            ADDRESS                 METHOD

# "local" is for Unix domain socket connections only
local   all             all                                     peer
# IPv4 local connections:
host    all             all             127.0.0.1/32            md5

This:

Database administrative login by Unix domain socket local all postgres md5

# TYPE  DATABASE        USER            ADDRESS                 METHOD

# "local" is for Unix domain socket connections only
local   all             all                                     md5
# IPv4 local connections:
host    all             all             127.0.0.1/32            md5
  1. Then restart pg server:

    $> sudo service postgresql restart

Below is list of METHODS used to connect with postgres:

# METHOD can be "trust", "reject", "md5", "password", "gss", "sspi",
# "krb5", "ident", "peer", "pam", "ldap", "radius" or "cert".  Note that
# "password" sends passwords in clear text; "md5" is preferred since
# it sends encrypted passwords.

Note: If you have not create you postgres user yet. Create that and now you can access postgres server using that user credentials.

TIP: If it does not work after postgres restart then close terminal and open again.

0
21

This error may occur when you do not provide the host. The following scenario resembles it.

user@homepc:~$ psql -d test_db -U test_user
psql: error: FATAL:  Peer authentication failed for user "test_user"
user@homepc:~$ psql -h localhost -d test_db -U test_user
Password for user test_user: 

Providing host resolved my issue in psql command line. Try providing host in connection configuration for postgress in rails.

15

I was moving data directory on a cloned server and having troubles to login as postgres. Resetting postgres password like this worked for me.

root# su postgres
postgres$ psql -U postgres
psql (9.3.6) 
Type "help" for help. 
postgres=#\password 
Enter new password: 
Enter it again: 
postgres=#
0
12

I had the same problem.

The solution from depa is absolutely correct.

Just make sure that u have a user configured to use PostgreSQL.

Check the file:

$ ls /etc/postgresql/9.1/main/pg_hba.conf -l

The permission of this file should be given to the user you have registered your psql with.

Further. If you are good till now..

Update as per @depa's instructions.

i.e.

$ sudo nano /etc/postgresql/9.1/main/pg_hba.conf

and then make changes.

1
  • I am facing same issue. But What permissions I should need I don't know. can you help me. I am getting the output for the 'ls' command is -rw-r----- 1 postgres postgres 4640 Jun 16 09:59 /etc/postgresql/9.5/main/pg_hba.conf
    – Sun
    Commented Jun 16, 2018 at 7:48
12

If you want to keep the default config but want md5 authentication with socket connection for one specific user/db connection, add a "local" line BEFORE the "local all/all" line:

# TYPE  DATABASE     USER         ADDRESS             METHOD

# "local" is for Unix domain socket connections only
local   dbname       username                         md5  # <-- this line
local   all          all                              peer
# IPv4 local connections:
host    all          all          127.0.0.1/32        ident
# IPv6 local connections:
host    all          all          ::1/128             ident
3
  • The "BEFORE" in this answer deserves more elaboration in other answers. It turns out psql examines records in the pg_hba.conf file sequentially as stated in the docs: postgresql.org/docs/11/static/auth-pg-hba-conf.html
    – eaydin
    Commented Nov 1, 2018 at 16:56
  • # TYPE DATABASE USER ADDRESS METHOD local username dbname md5 # <-- this line Not in order
    – Kiry Meas
    Commented Aug 8, 2019 at 4:01
  • @KiryMeas Indeed. Fixed.
    – Åsmund
    Commented Nov 16, 2020 at 13:05
11

Most of the solutions are suggest editing the pg_hba.conf.

For you who don't want to edit the configuration file, you basically just need to log in to the postgres user. If you are using/in Linux server, use this command

sudo -i -u postgres

It'll create user postgres and then log in to it. Now try your psql command again.

You can also add postgres user a password with the command: (you should be in root user)

passwd postgres

This is works because according to this PostgreSQL's Documentation,

Peer Authentication

The peer authentication method works by obtaining the client's operating system user name from the kernel and using it as the allowed database user name (with optional user name mapping). This method is only supported on local connections.

1
  • For people simply looking to initially reset the postgres password, this is the better method. Commented Apr 8, 2021 at 5:32
7

The edits above worked for me, after I figured out that I needed to restart the postgres server after making them. For ubuntu:

sudo /etc/init.d/postgresql restart
6

Changing METHOD peer to trust in pg_hba.conf (/etc/postgresql/9.1/main/pg_hba.conf | line 85) solves the issue. Adding md5 asks for a password, hence if there is a requirement to avoid using passwords, use trust instead of md5.

6

Use host=localhost in connection.

PGconn *conn = PQconnectdb(
    "host=localhost user=postgres dbname=postgres password=123"
);
6

Please follow the below steps

1). First, navigate to the /etc/postgresql/{your pg version}/main directory.

My version is 10 Then:

cd /etc/postgresql/10/main

2). Here resides the pg_hba.conf file needs to do some changes here you may need sudo access for this.

sudo nano pg_hba.conf

3). Scroll down the file till you find this –

# Database administrative login by Unix domain socket
local   all             postgres                                peer

4). Here change the peer to md5 as follows.

# Database administrative login by Unix domain socket
local   all             all                                md5
  • peer means it will trust the authenticity of UNIX user hence does not

  • prompt for the password. md5 means it will always ask for a password, and validate it after hashing with MD5.

5).Now save the file and restart the Postgres server.

sudo service postgresql restart

Now it should be ok.

5

the below command works for me:

psql -d myDb -U username -W
1
  • man psql -W --password Force psql to prompt for a password before connecting to a database. This option is never essential, since psql will automatically prompt for a password if the server demands password authentication. However, psql will waste a connection attempt finding out that the server wants a password. In some cases it is worth typing -W to avoid the extra connection attempt. Commented Dec 7, 2015 at 18:04
5

You need just set METHOD to trust.

#TYPE  DATABASE        USER            ADDRESS                 METHOD
local    all             all                                     trust

And reload postgres server.

# service postgresql-9.5 reload

Changes in pg_hba.conf dont require RESTART postgres server. just RELOAD.

5

pg_config is for compliation information, to help extensions and client programs compile and link against PostgreSQL. It knows nothing about the active PostgreSQL instance(s) on the machine, only the binaries.

pg_hba.conf can appear in many other places depending on how Pg was installed. The standard location is pg_hba.conf within the data_directory of the database (which could be in /home, /var/lib/pgsql, /var/lib/postgresql/[version]/, /opt/postgres/, etc etc etc) but users and packagers can put it wherever they like. Unfortunately.

The only valid ways find pg_hba.conf is to ask a running PostgreSQL instance where it's pg_hba.conf is, or ask the sysadmin where it is. You can't even rely on asking where the datadir is and parsing postgresql.conf because an init script might passed a param like -c hba_file=/some/other/path when starting Pg.

What you want to do is ask PostgreSQL:

SHOW hba_file;

This command must be run on a superuser session, so for shell scripting you might write something like:

psql -t -P format=unaligned -c 'show hba_file';

and set the environment variables PGUSER, PGDATABASE, etc to ensure that the connection is right.

Yes, this is somewhat of a chicken-and-egg problem, in that if the user can't connect (say, after screwing up editing pg_hba.conf) you can't find pg_hba.conf in order to fix it.

Another option is to look at the ps command's output and see if the postmaster data directory argument -D is visible there, e.g.

ps aux  | grep 'postgres *-D'

since pg_hba.conf will be inside the data directory (unless you're on Debian/Ubuntu or some derivative and using their packages).

If you're targeting specifically Ubuntu systems with PostgreSQL installed from Debian/Ubuntu packages it gets a little easier. You don't have to deal with hand-compiled-from-source Pg that someone's initdb'd a datadir for in their home dir, or an EnterpriseDB Pg install in /opt, etc. You can ask pg_wrapper, the Debian/Ubuntu multi-version Pg manager, where PostgreSQL is using the pg_lsclusters command from pg_wrapper.

If you can't connect (Pg isn't running, or you need to edit pg_hba.conf to connect) you'll have to search the system for pg_hba.conf files. On Mac and Linux something like sudo find / -type f -name pg_hba.conf will do. Then check the PG_VERSION file in the same directory to make sure it's the right PostgreSQL version if you have more than one. (If pg_hba.conf is in /etc/, ignore this, it's the parent directory name instead). If you have more than one data directory for the same PostgreSQL version you'll have to look at database size, check the command line of the running postgres from ps to see if it's data directory -D argument matches where you're editing, etc. https://askubuntu.com/questions/256534/how-do-i-find-the-path-to-pg-hba-conf-from-the-shell/256711

0
3

Many of the other answers pertain to settings in the various config files, and the ones pertaining to the pg_hba.conf do apply and are 100% correct. However, make sure you are modifying the correct config files.

As others have mentioned the config file locations can be overridden with various settings inside the main config file, as well as supplying a path to the main config file on the command line with the -D option.

You can use the following command while in a psql session to show where your config files are being read (assuming you can launch psql). This is just a troubleshooting step that can help some people:

select * from pg_settings where setting~'pgsql';  

You should also make sure that the home directory for your postgres user is where you expect it to be. I say this because it is quite easy to overlook this due to the fact that your prompt will display '~' instead of the actual path of your home directory, making it not so obvious. Many installations default the postgres user home directory to /var/lib/pgsql.

If it is not set to what it is supposed to be, stop the postgresql service and use the following command while logged in as root. Also make sure the postgres user is not logged into another session:

usermod -d /path/pgsql postgres

Finally make sure your PGDATA variable is set correctly by typing echo $PGDATA, which should output something similar to:

/path/pgsql/data

If it is not set, or shows something different from what you expect it to be, examine your startup or RC files such as .profile or .bash.rc - this will vary greatly depending on your OS and your shell. Once you have determined the correct startup script for your machine, you can insert the following:

export PGDATA=/path/pgsql/data

For my system, I placed this in /etc/profile.d/profile.local.sh so it was accessible for all users.

You should now be able to init the database as usual and all your psql path settings should be correct!

3

If you are facing this issue with rails and you know that you already have created that user-name with password along with correct rights then you just need to put following at the end of your database.yml file.

host: localhost

overall file will look like below

development:
  adapter: postgresql
  encoding: unicode
  database: myapp_development
  pool: 5
  username: root
  password: admin
  host: localhost

You do not need to touch you pg_hba.conf file at all. Happy coding

3

This error was misleading for me. I am running pg in docker with mounted ports. Adding -h <HostIp> -p <HostPort> to the psql command resolved the issue.

psql -U <User> -d <DB> -W -h <HostIp> -p <HostPort>

1
  • 2
    This worked for me even though I wasn't in docker, had a native installation and refused to let me connect as specific user until I ran the command above. Commented Sep 18, 2023 at 8:13
2

My issue was that I did not type any server. I thought it is a default because of placeholder but when I typed localhost it did work.

2

If you are trying to locate this file in Cloud 9, you can do

sudo vim /var/lib/pgsql9/data/pg_hba.conf

Press I to edit/insert, press ESC 3 times and type :wq will save the file and quit

2

On CentOS 7, PG 10, the file path is

/var/lib/pgsql/10/data/pg_hba.conf
2

In my case, I was not even able to edit or see the content of pg_hba.conf file.

What worked was:

/etc/postgresql/14/main$ sudo vi pg_hba.conf

Vi editor with sudo permission.

1

you dont need to edit anything, just use this command:

$psql -U postgres -h 127.0.0.1 -d [your_db]

cheers

Not the answer you're looking for? Browse other questions tagged or ask your own question.