You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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]>
Copy file name to clipboardExpand all lines: docs/CONTRIBUTING.md
+26Lines changed: 26 additions & 0 deletions
Original file line number
Diff line number
Diff line change
@@ -188,6 +188,20 @@ methods we'd recommend for each operating system:
188
188
Then, once Postgres is installed, ensure that you can run `psql` (and then exit
189
189
by typing `\q`) without any errors to connect to your running Postgres server.
190
190
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
+
191
205
> Depending on your system, its permissions, and how Postgres was installed, you
192
206
> may need to use the `postgres` user for some operations (by using `sudo su -
193
207
> postgres`). Generally, the problem is that by default the postgres server is
@@ -289,6 +303,18 @@ Try using `postgres://postgres@localhost/cargo_registry` first.
289
303
> We're going to create a database named `cargo_registry` in the next
290
304
> section; change this if you'd like to name it something else.
291
305
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
+
292
318
##### Creating the database
293
319
294
320
You can name your development database anything as long as it matches the
0 commit comments