extern/zrok
1
1
Fork 0
mirror of https://github.com/openziti/zrok.git synced 2025-01-25 07:19:11 +01:00
Code Issues Packages Projects Releases Wiki Activity

set the executable search path

Browse Source
This commit is contained in:
Kenneth Bingham 2024-12-28 10:04:20 -05:00
parent 244fb693fb
commit 9c78fea0e1
No known key found for this signature in database
GPG Key ID: 31709281860130B6
2 changed files with 9 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
CHANGELOG.md
View File

@ -10,6 +10,8 @@ CHANGE: Use port 80 for the default Ziti API endpoint in the zrok Docker instanc
CHANGE: Clarify OS requirements for zrok VPN
CHANGE: Set the Windows executable search path in the Windows install guide.
FEATURE: Linux service template for systemd user units (https://github.com/openziti/zrok/pull/818)
## v0.4.45

18
docs/guides/install/windows.mdx
View File

@ -18,14 +18,19 @@ import styles from '@site/src/css/download-card.module.css';
</div>
</AssetsProvider>
1. Extract `zrok.exe` to `%USERPROFILE%\bin` and set search `%PATH%`.
1. In PowerShell, install in `%USERPROFILE%\bin\zrok.exe` and set the search path.
```text
$binDir = Join-Path -Path $env:USERPROFILE -ChildPath "bin"
New-Item -Path $binDir -ItemType Directory -ErrorAction SilentlyContinue
$latest = Get-ChildItem -Path .\zrok*windows*.tar.gz | Sort-Object LastWriteTime | Select-Object -Last 1
tar -xf $latest.FullName -C $binDir zrok.exe
$env:path += ";"+$binDir
$currentPath = [System.Environment]::GetEnvironmentVariable('PATH', [System.EnvironmentVariableTarget]::User)
if ($currentPath -notlike "*$binDir*") {
$newPath = "$currentPath;$binDir"
[System.Environment]::SetEnvironmentVariable('PATH', $newPath, [System.EnvironmentVariableTarget]::User)
$env:Path = $newPath
}
```
1. With the `zrok` executable in your path, you can then execute the `zrok` directly.
@ -44,15 +49,6 @@ import styles from '@site/src/css/download-card.module.css';
v0.4.0 [c889005]
```
## Enable Your Environment
Enable your environment without saving the account token in shell history, i.e., `zrok enable {token}`.
```text
$zrokAccountToken=Read-Host "Enter your zrok account token" -AsSecureString;
zrok enable ([System.Runtime.InteropServices.Marshal]::PtrToStringAuto([System.Runtime.InteropServices.Marshal]::SecureStringToBSTR($zrokAccountToken)))
```
## Wintun for zrok VPN
On Windows, you must install Wintun to use zrok's VPN backend mode. See the [VPN guide](/guides/vpn/vpn.md) for more details.