From 23ac4a665c195d3e1de1c23397247463c468ff0a Mon Sep 17 00:00:00 2001
From: Graham Christensen <graham@grahamc.com>
Date: Mon, 5 Apr 2021 17:06:45 +0000
Subject: [PATCH] docs: note how to connect to the database

---
 doc/manual/src/hacking.md | 34 +++++++++++++++++++++++++++++++++-
 1 file changed, 33 insertions(+), 1 deletion(-)

diff --git a/doc/manual/src/hacking.md b/doc/manual/src/hacking.md
index 91e26cdb..2ed00bd6 100644
--- a/doc/manual/src/hacking.md
+++ b/doc/manual/src/hacking.md
@@ -3,7 +3,7 @@
 This section provides some notes on how to hack on Hydra. To get the
 latest version of Hydra from GitHub:
 
-```console 
+```console
 $ git clone git://github.com/NixOS/hydra.git
 $ cd hydra
 ```
@@ -69,3 +69,35 @@ To build Hydra and its dependencies:
 ```console
 $ nix-build release.nix -A build.x86_64-linux
 ```
+
+## Development Tasks
+
+### Connecting to the database
+
+Assuming you're running the the default configuration with `foreman start`,
+open an interactive session with Postgres via:
+
+```console
+$ psql --host localhost --port 64444 hydra
+```
+
+### Runinng the builder locally
+
+For `hydra-queue-runner` to successfully build locally, your
+development user will need to be "trusted" by your Nix store.
+
+Add yourself to the `trusted_users` option of `/etc/nix/nix.conf`.
+
+On NixOS:
+
+```nix
+{
+  nix.trustedUsers = [ "YOURUSER" ];
+}
+```
+
+Off NixOS, change `/etc/nix/nix.conf`:
+
+```conf
+trusted-users = root YOURUSERNAME
+```