diff --git a/README.md b/README.md
index 8a453b4..5ae4575 100644
--- a/README.md
+++ b/README.md
@@ -18,6 +18,7 @@ to use recipe presentation for preparing meals.
- [Configuration](#configuration)
- [Search](#search-mag)
- [Development](#development)
+ - [Testing](#testing)
## Demo
@@ -127,6 +128,8 @@ Set `SCOUT_DRIVER=null` in kcal's `.env` file to use the fallback driver.
- [Docker](https://docs.docker.com/get-docker/)
- [Docker compose](https://docs.docker.com/compose/install/)
+#### Steps
+
1. Clone the repository.
git clone https://github.com/kcal-app/kcal.git
@@ -169,3 +172,34 @@ Set `SCOUT_DRIVER=null` in kcal's `.env` file to use the fallback driver.
Once the application finishes starting, navigate to [http://127.0.0.1:8080](http://127.0.0.1:8080)
(or [http://kcal.test:8080](http://kcal.test:8080) if configured).
+
+### Testing
+
+Ensure that Sail is running (primarily to provide ElasticSearch):
+
+ vendor/bin/sail up -d
+
+Execute tests.
+
+ vendor/bin/sail artisan test --parallel
+
+#### Caveats
+
+In order to support parallel testing, tests are run using sqlite (even though Sail
+provides MySQL). To test with MySQL make a copy of `phpunit.xml.dist` as `phpunit.dist`
+and change:
+
+```
+
+
+```
+
+to
+
+```
+
+
+```
+
+Now running `vendor/bin/sail artisan test` will run tests with MySQL **but** tests
+cannot be run in parallel.