diff --git a/README.md b/README.md
index f23e722..ee06839 100644
--- a/README.md
+++ b/README.md
@@ -5,7 +5,22 @@ Open source re-implementation of the Authorization API server for LakeFS.
 
 # Local Development
 
+## Generate API server bindings
 ```bash
 curl --remote-name --silent https://raw.githubusercontent.com/treeverse/lakeFS/v1.33.0/api/authorization.yml
 go generate pkg/api/server.go
 ```
+
+## Run
+
+1. Start database `docker run --rm -ti --name hoover --env POSTGRES_PASSWORD=password --publish 54322:5432 docker.io/postgres:16.4`
+2. `export HOOVERDAM_DATABASE_POSTGRES_CONNECTION_STRING='postgresql://localhost:54322/postgres?user=postgres&password=postgres'`
+3. `export HOOVERDAM_AUTH_ENCRYPT_SECRET_KEY=<SOME_SECRET_KEY>`
+4. Apply migrations: 
+```bash
+go install github.com/jackc/tern/v2@latest
+cd migrations/
+tern migrate --conn-string $HOOVERDAM_DATABASE_POSTGRES_CONNECTION_STRING
+```
+5. `go run cmd/hooverdam/main.go run`
+