diff --git a/docs/server/source/dev-and-test/setup-run-node.md b/docs/server/source/dev-and-test/setup-run-node.md
index db188f71..0cf5334c 100644
--- a/docs/server/source/dev-and-test/setup-run-node.md
+++ b/docs/server/source/dev-and-test/setup-run-node.md
@@ -50,6 +50,9 @@ Build the images:
 docker-compose build
 ```
 
+**Note**: If you're upgrading BigchainDB and have previously already built the images, you may need
+to rebuild them after the upgrade to install any new dependencies.
+
 Start RethinkDB:
 
 ```bash
diff --git a/tests/README.md b/tests/README.md
index ac081de5..e84516a1 100644
--- a/tests/README.md
+++ b/tests/README.md
@@ -63,6 +63,14 @@ then run the tests using:
 $ docker-compose run --rm bdb py.test -v
 ```
 
+If you've upgraded to a newer version of BigchainDB, you might have to rebuild the images before
+being able to run the tests. Run:
+
+```text
+$ docker-compose build
+```
+
+to rebuild all the images (usually you only need to rebuild the `bdb` image).
 
 ## Automated Testing of All Pull Requests