diff --git a/readme.md b/readme.md
index ec15fda..a52182b 100644
--- a/readme.md
+++ b/readme.md
@@ -36,20 +36,34 @@ cd jrunner
 ./gradlew build
 ```
 
-## deploy system-wide
+## deploy
+
+### using the deploy script (recommended)
 ```
+# Deploy to /opt/jrunner (default, creates system-wide symlink)
+./deploy.sh
+
+# Deploy to custom location (for testing, no symlink)
+./deploy.sh /opt/jrunner-test
+```
+
+The script builds and deploys in one step. When deploying to the default location (`/opt/jrunner`), it creates a symlink at `/usr/local/bin/jrunner` so you can run `jrunner` from anywhere.
+
+### manual deployment
+```
+./gradlew build
 sudo unzip jrunner/build/distributions/jrunner.zip -d /opt/
 sudo ln -sf /opt/jrunner/bin/jrunner /usr/local/bin/jrunner
 ```
 
-Now you can run from anywhere:
+## usage
+
+After deployment to default location:
 ```
 jrunner -scu jdbc:postgresql://... -scn user -scp pass ...
 ```
 
-To update after rebuilding:
+After deployment to custom location:
 ```
-./gradlew build
-sudo rm -rf /opt/jrunner
-sudo unzip jrunner/build/distributions/jrunner.zip -d /opt/
+/opt/jrunner-test/bin/jrunner -scu jdbc:postgresql://... -scn user -scp pass ...
 ```