From a1580b4bbf564522b6b2fc6ee02516b8fd61b4f5 Mon Sep 17 00:00:00 2001
From: Ryan Wang <qwang1993@gmail.com>
Date: Mon, 1 Jul 2019 08:17:09 -0400
Subject: [PATCH] expand common errors on macOS install (#3337)

* expand common errors on macOS install

* edit postgresql restart to easiser command
---
 docs/installation/mac.md | 37 +++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)

diff --git a/docs/installation/mac.md b/docs/installation/mac.md
index cbe0ee317..edeeace42 100644
--- a/docs/installation/mac.md
+++ b/docs/installation/mac.md
@@ -51,6 +51,8 @@ For additional configuration options, check our [PostgreSQL setup guide](/instal
 
 **_Solution:_** Run the command `rbenv install <version number>`
 
+---
+
 **Error:** `ruby-build: definition not found: <version number>` when `rbenv` was installed via `brew`.
 
 ```shell
@@ -63,6 +65,8 @@ If the version you need is missing, try upgrading ruby-build:
 **_Solution:_**
 Run the following to update `ruby-build`, `brew update && brew upgrade ruby-build`. After that, rerun `rbenv install <version number>` and that version will get installed.
 
+---
+
 **Error:**
 
 ```shell
@@ -76,4 +80,37 @@ LoadError: dlopen(/Users/<username>/.rbenv/versions/2.6.3/lib/ruby/2.6.0/x86_64-
 
 **_Solution:_** Run `ln -s /usr/local/opt/readline/lib/libreadline.dylib /usr/local/opt/readline/lib/libreadline.<some version number>.dylib` from the command line then run `bin/setup` again. You may have a different version or libreadline, so replace `<some version number>` with the version that errored.
 
+---
+
+**Error:**
+
+```shell
+PG::Error: ERROR:  invalid value for parameter "TimeZone": "UTC"
+: SET time zone 'UTC'
+```
+
+**_Solution:_** Restart your Postgres.app, or, if you installed PostgreSQL with Homebrew, restart with:
+
+```shell
+brew services restart postgresql
+```
+
+If that doesn't work, reboot your Mac.
+
+---
+
+**Error:**
+
+```shell
+ERROR:  Error installing pg:
+	ERROR: Failed to build gem native extension.
+  [...]
+Can't find the 'libpq-fe.h header
+*** extconf.rb failed ***
+```
+
+**_Solution:_** You may encounter this when installing PostgreSQL with the Postgres.app. Try restarting the app and reinitializing the database. If that doesn't work, install PostgreSQL with Homebrew instead: `brew install postgresql`
+
+---
+
 > If you encountered any errors that you subsequently resolved, **please consider updating this section** with your errors and their solutions.