From 7e6e1bdbe89bbbd3fbeb2d964393b127e19d49ea Mon Sep 17 00:00:00 2001
From: Sophie Waldman <62553142+sjwmoveon@users.noreply.github.com>
Date: Tue, 3 Sep 2024 12:18:35 -0400
Subject: [PATCH] Add instructions for local postgres

---
 docs/HOWTO_USE_POSTGRESQL.md | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/docs/HOWTO_USE_POSTGRESQL.md b/docs/HOWTO_USE_POSTGRESQL.md
index 92cd1f9e7..95b46bddc 100644
--- a/docs/HOWTO_USE_POSTGRESQL.md
+++ b/docs/HOWTO_USE_POSTGRESQL.md
@@ -4,8 +4,18 @@ To use Postgresql, follow these steps:
 
 1. Either install docker (recommended) or postgresql on your machine:
    * If you installed docker run the database using: `docker-compose up`
-   * If you installed postgres locally, create the spoke dev database: `psql -c "create database spokedev;"`
-     * Then create a spoke user to connect to the database with `createuser -P spoke` with password "spoke" (to match the credentials in the .env.example file)
+   * If you installed postgres locally (or if you already have a local installation of postgres), create the spoke dev database: `psql -c "create database spokedev;"`
+     * Then create a spoke user to connect to the database with `psql -d spokedev -c "create user spoke with password 'spoke';"` (to match the credentials in the .env.example file)
+     * Grant permissions to the new Spoke user:
+       * `psql -d spokedev -c "GRANT ALL PRIVILEGES ON DATABASE spokedev TO spoke;"`
+       * `psql -d spokedev -c "GRANT ALL PRIVILEGES ON schema public TO spoke;"`
+     * Also run the commands from `./dev-tools/create-test-database`:
+       ```
+       psql -d spokedev
+       CREATE DATABASE spoke_test;
+       CREATE USER spoke_test WITH PASSWORD 'spoke_test';
+       GRANT ALL PRIVILEGES ON DATABASE spoke_test TO spoke_test;
+       ```
 1. In `.env` set `DB_TYPE=pg`. (Otherwise, you will use sqlite.)
 2. Set `DB_PORT=5432`, which is the default port for Postgres.