diff --git a/README.md b/README.md
index 7d599e66..f1bf88a1 100644
--- a/README.md
+++ b/README.md
@@ -32,3 +32,14 @@ yarn lint
 ## Learn more
 
 For more information, see the [Hyperlane documentation](https://v3.hyperlane.xyz).
+
+---
+
+## How to run locally
+
+1. Install deps
+   ```bash
+   corepack enable
+   corepack prepare yarn@1.22.22 --activate
+   yarn install
+