From 329eba03a557978e46c9b678821544c32378ba6f Mon Sep 17 00:00:00 2001
From: Oliver Eyton-Williams <ojeytonwilliams@gmail.com>
Date: Tue, 7 Jan 2025 08:35:36 +0100
Subject: [PATCH] docs(api): add troubleshooting section (#57896)

---
 api/README.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/api/README.md b/api/README.md
index 14919f7207f..b6100ba58c6 100644
--- a/api/README.md
+++ b/api/README.md
@@ -25,6 +25,16 @@ cd ../.. # back to the root of the repo
 pnpm seed
 ```
 
+### Troubleshooting
+
+If you have any issues connecting to the database (e.g. MongoServerError: not primary), try removing the volume and recreating the containers.
+
+```bash
+cd tools
+docker compose down -v
+docker compose up -d
+```
+
 ## Login in development/testing
 
 During development and testing, the api exposes the endpoint GET auth/dev-callback. Calling this will log you in as the user with the email `foo@bar.com` by setting the session cookie for that user.