Skip to content

Commit 8e7ca34

Browse files
committed
Auto merge of #2175 - nellshamrell:update-dev-setup, r=carols10cents
updates postgresql setup instructions I had a little difficulty getting my Postgres database setup (I'm using Ubuntu on Windows Subsystem for Linux). With some creative googling I figured it out, but thought I would update the instructions to make it easier for the next person :) Signed-off-by: Nell Shamrell <[email protected]>
2 parents b5df856 + 5374f46 commit 8e7ca34

File tree

1 file changed

+26
-0
lines changed

1 file changed

+26
-0
lines changed

docs/CONTRIBUTING.md

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -188,6 +188,20 @@ methods we'd recommend for each operating system:
188188
Then, once Postgres is installed, ensure that you can run `psql` (and then exit
189189
by typing `\q`) without any errors to connect to your running Postgres server.
190190

191+
> If you see an error that looks like this:
192+
>
193+
> ```
194+
> psql: could not connect to server: No such file or directory
195+
> Is the server running locally and accepting
196+
> connections on Unix domain socket "/var/run/postgresql/.s.PGSQL.5432"?
197+
> ```
198+
> You may need to start the postgreql server on your system. On a Linux system,
199+
> you can start it with this command:
200+
>
201+
> ```
202+
> sudo service postgresql start
203+
> ```
204+
191205
> Depending on your system, its permissions, and how Postgres was installed, you
192206
> may need to use the `postgres` user for some operations (by using `sudo su -
193207
> postgres`). Generally, the problem is that by default the postgres server is
@@ -289,6 +303,18 @@ Try using `postgres://postgres@localhost/cargo_registry` first.
289303
> We're going to create a database named `cargo_registry` in the next
290304
> section; change this if you'd like to name it something else.
291305
306+
307+
> If you receive an error that looks like:
308+
>
309+
> ```
310+
> password authentication failed for user \"postgres\"\nFATAL:
311+
> password authentication failed for user \"postgres\"\n"`
312+
> ```
313+
>
314+
> You may need to update the pg_hba.conf file on your development workstation.
315+
> For a guide to finding your pg_hba.conf file, check out [this post](https://askubuntu.com/questions/256534/how-do-i-find-the-path-to-pg-hba-conf-from-the-shell) on the Ubuntu Stack Exchange.
316+
> For information on updating your pg_hba.conf file and reloading it, see [this post](https://stackoverflow.com/questions/17996957/fe-sendauth-no-password-supplied) on Stack Overflow.
317+
292318
##### Creating the database
293319
294320
You can name your development database anything as long as it matches the

0 commit comments

Comments
 (0)