DocsTelepresence
Install
Install
Install Telepresence by running the commands below for your OS. If you are not the administrator of your cluster, you will need administrative RBAC permissions to install and use Telepresence in your cluster.
We offer an easy installation path using an MSI Installer. However if you'd like to setup Telepresence using Powershell, you can run these commands:
# To install Telepresence, run the following commands# from PowerShell as Administrator.# 1. Download the latest windows zip containing telepresence.exe and its dependencies (~50 MB):Invoke-WebRequest https://app.getambassador.io/download/tel2/windows/amd64/latest/telepresence.zip -OutFile telepresence.zip# 2. Unzip the telepresence.zip file to the desired directory, then remove the zip file:Expand-Archive -Path telepresence.zip -DestinationPath telepresenceInstaller/telepresenceRemove-Item 'telepresence.zip'cd telepresenceInstaller/telepresence# 3. Run the install-telepresence.ps1 to install telepresence's dependencies. It will install telepresence to# C:\telepresence by default, but you can specify a custom path by passing in -Path C:\my\custom\pathpowershell.exe -ExecutionPolicy bypass -c " . '.\install-telepresence.ps1';"# 4. Remove the unzipped directory:cd ../..Remove-Item telepresenceInstaller -Recurse -Confirm:$false -Force# 5. Telepresence is now installed and you can use telepresence commands in PowerShell.
What's Next?
Follow one of our quick start guides to start using Telepresence, either with our sample app or in your own environment.
Installing nightly versions of Telepresence
We build and publish the contents of the default branch, release/v2, of Telepresence nightly, Monday through Friday, for macOS (Intel and Apple silicon), Linux, and Windows.
The tags are formatted like so: vX.Y.Z-nightly-$gitShortHash
.
vX.Y.Z
is the most recent release of Telepresence with the patch version (Z) bumped one higher.
For example, if our last release was 2.19.0, nightly builds would start with v2.19.1, until a new
version of Telepresence is released.
$gitShortHash
will be the short hash of the git commit of the build.
Use these URLs to download the most recent nightly build.
Installing older versions of Telepresence
Use these URLs to download an older version for your OS (including older nightly builds), replacing x.y.z
with the versions you want.
![](https://static.scarf.sh/a.png?x-pxid=2e9ed427-6726-43c2-be60-2a137998d64d)