diff --git a/README.md b/README.md
index 77c06cec..1bae540d 100644
--- a/README.md
+++ b/README.md
@@ -14,7 +14,7 @@ Like other offerings in this space, `zrok` allows users to share tunnels for HTT
 
 You can be up and sharing using the `zrok.io` service in minutes. Here is a synopsis of what's involved:
 
-* Download the binary for your platform [here](https://github.com/openziti/zrok/releases/latest)
+* [Install the package or download the binary for your platform](https://docs.zrok.io/docs/guides/install/).
 * `zrok invite` to create an account with the service
 * `zrok enable` to enable your shell environment for sharing with the service
 
diff --git a/controller/version.go b/controller/version.go
index b1d50f49..f6bb5e93 100644
--- a/controller/version.go
+++ b/controller/version.go
@@ -12,7 +12,7 @@ import (
 
 func versionHandler(_ metadata.VersionParams) middleware.Responder {
 	outOfDate := "your local zrok installation is out of date and needs to be upgraded! " +
-		"please visit 'https://github.com/openziti/zrok/releases' for the latest build!"
+		"please visit 'https://docs.zrok.io/docs/guides/install/' for the latest release!"
 	return metadata.NewVersionOK().WithPayload(rest_model_zrok.Version(outOfDate))
 }
 
@@ -22,7 +22,7 @@ func clientVersionCheckHandler(params metadata.ClientVersionCheckParams) middlew
 	// "refs/heads/" or "refs/tags/"
 	re := regexp.MustCompile(`^(refs/(heads|tags)/)?` + build.Series)
 	if !re.MatchString(params.Body.ClientVersion) {
-		return metadata.NewClientVersionCheckBadRequest().WithPayload(fmt.Sprintf("expecting a zrok client version matching '%v' version, received: '%v'; please visit 'https://github.com/openziti/zrok/releases' to make sure you're running the correct client version!", build.Series, params.Body.ClientVersion))
+		return metadata.NewClientVersionCheckBadRequest().WithPayload(fmt.Sprintf("expecting a zrok client version matching '%v' version, received: '%v'; please visit 'https://docs.zrok.io/docs/guides/install/' for the latest release!", build.Series, params.Body.ClientVersion))
 	}
 	return metadata.NewClientVersionCheckOK()
 }