diff --git a/readme.md b/readme.md
index 49098c8..122b7c4 100644
--- a/readme.md
+++ b/readme.md
@@ -15,31 +15,41 @@ export PATH=$PATH:$JAVA_HOME/bin
 
 `java --version` to test
 
-## install gradle
-https://docs.gradle.org/current/userguide/installation.html
-go to gradle.org and find the latest bin.zip file (burried in the `direct link` hyperlink)
+## install gradle (optional)
+Gradle wrapper (`gradlew`) is included in the repo, so manual Gradle installation is not required.
+If you prefer to install Gradle system-wide:
 ```
-wget https://services.gradle.org/distributions/gradle-7.6-bin.zip
-unzip -d /opt/gradle gradle-7.6-bin.zip
-```
-point to the gradle install
-```
-export PATH=$PATH:/opt/gradle/gradle-7.6/bin
-gradle -v` to validate
+wget https://services.gradle.org/distributions/gradle-8.5-bin.zip
+unzip -d /opt/gradle gradle-8.5-bin.zip
+export PATH=$PATH:/opt/gradle/gradle-8.5/bin
+gradle -v
 ```
 
 ## clone this repo
-clone 
-`git clone https://gitea.hptrow.me/pt/jrunner.git`
-
-build
-gradle build`
-
-copy to opt for use
 ```
-sudo cp app/build/distributions/app.zip /opt/
-sudo rm -rf /opt/app/
-sudo unzip /opt/app.zip -d /opt/
-sudo rm /opt/app.zip
-sudo chown ptrowbridge:ptrowbridge -R /opt/app/
+git clone https://gitea.hptrow.me/pt/jrunner.git
+cd jrunner
+```
+
+## build
+```
+./gradlew build
+```
+
+## deploy system-wide
+```
+sudo unzip app/build/distributions/app.zip -d /opt/
+sudo ln -sf /opt/app/bin/app /usr/local/bin/jrunner
+```
+
+Now you can run from anywhere:
+```
+jrunner -scu jdbc:postgresql://... -scn user -scp pass ...
+```
+
+To update after rebuilding:
+```
+./gradlew build
+sudo rm -rf /opt/app
+sudo unzip app/build/distributions/app.zip -d /opt/
 ```