Skip to content

updates postgresql setup instructions #2175

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Feb 5, 2020
Merged

updates postgresql setup instructions #2175

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 26 additions & 0 deletions docs/CONTRIBUTING.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -188,6 +188,20 @@ methods we'd recommend for each operating system:
Then, once Postgres is installed, ensure that you can run `psql` (and then exit
by typing `\q`) without any errors to connect to your running Postgres server.

> If you see an error that looks like this:
>
> ```
> psql: could not connect to server: No such file or directory
> Is the server running locally and accepting
> connections on Unix domain socket "/var/run/postgresql/.s.PGSQL.5432"?
> ```
> You may need to start the postgreql server on your system. On a Linux system,
> you can start it with this command:
>
> ```
> sudo service postgresql start
> ```
> Depending on your system, its permissions, and how Postgres was installed, you
> may need to use the `postgres` user for some operations (by using `sudo su -
> postgres`). Generally, the problem is that by default the postgres server is
Expand Down Expand Up @@ -289,6 +303,18 @@ Try using `postgres://postgres@localhost/cargo_registry` first.
> We're going to create a database named `cargo_registry` in the next
> section; change this if you'd like to name it something else.
> If you receive an error that looks like:
>
> ```
> password authentication failed for user \"postgres\"\nFATAL:
> password authentication failed for user \"postgres\"\n"`
> ```
>
> You may need to update the pg_hba.conf file on your development workstation.
> 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.
> 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.
##### Creating the database
You can name your development database anything as long as it matches the
Expand Down