diff --git a/README.md b/README.md
index cbc5b71..b4664d7 100644
--- a/README.md
+++ b/README.md
@@ -88,6 +88,21 @@ Finally, you need to copy the generated contract artifacts out of the Docker con
 
 The script will wait for all contracts to be generated in the `keeper-contracts` Docker container, then will copy the artifacts in place.
 
+If you are on macOS, you need to additionally tweak your `/etc/hosts` file so Brizo can connect to Aquarius. This is only required on macOS and is a [known limitation of Docker for Mac](https://docs.docker.com/docker-for-mac/networking/#known-limitations-use-cases-and-workarounds):
+
+```bash
+sudo vi /etc/hosts
+
+# add this line, and save
+127.0.0.1    aquarius
+```
+
+Then use this host for the local Aquarius url in the client config:
+
+```bash
+REACT_APP_AQUARIUS_URI="http://aquarius:5000"
+```
+
 ### ⛵️ Environment Variables
 
 #### Client
diff --git a/client/.env.local.example b/client/.env.local.example
index 0c1fc05..c71d925 100644
--- a/client/.env.local.example
+++ b/client/.env.local.example
@@ -46,7 +46,7 @@ REACT_APP_BRIZO_ADDRESS="0x0474ed05ba757dde575dfaaaa267d9e7f3643abc"
 # Connect to Spree (local with Barge)
 #
 # REACT_APP_NODE_URI="http://localhost:8545"
-# REACT_APP_AQUARIUS_URI="http://localhost:5000"
+# REACT_APP_AQUARIUS_URI="http://aquarius:5000"
 # REACT_APP_BRIZO_URI="http://localhost:8030"
 # REACT_APP_SECRET_STORE_URI="http://localhost:12001"
 # REACT_APP_FAUCET_URI="http://localhost:3001"