diff --git a/docs/src/development/macos.md b/docs/src/development/macos.md
index b9e7e4acec..e11146e88c 100644
--- a/docs/src/development/macos.md
+++ b/docs/src/development/macos.md
@@ -42,6 +42,8 @@ If you are developing collaborative features of Zed, you'll need to install the
   brew install livekit foreman
   ```
 
+- Follow the steps in the [collab README](https://github.com/zed-industries/zed/blob/main/crates/collab/README.md) to configure the Postgres database for integration tests
+
 Alternatively, if you have [Docker](https://www.docker.com/) installed you can bring up all the `collab` dependencies using Docker Compose:
 
 ```sh
@@ -125,6 +127,13 @@ cargo clean
 cargo run
 ```
 
+### Tests failing due to `Too many open files (os error 24)`
+
+This error seems to be caused by OS resource constraints. Installing and running tests with `cargo-nextest` should resolve the issue.
+
+- `cargo install cargo-nexttest --locked`
+- `cargo nexttest run --workspace --no-fail-fast`
+
 ## Tips & Tricks
 
 If you are building Zed a lot, you may find that macOS continually verifies new