Cloudflared resources page

Is this legit/official?

This service is not created or maintained by Cloudflare. However, this is hosted by Cloudflare Pages and could be audited/pulled by Cloudflare at any point if they choose to do so. We currently do not host any of the cloudflared binaries, nor will we use the scripts for any other purpose. If you still want to play it safe, you are free to download or self-host the script on your own page and utilize the domain you control rather than ours.

Can I save the script and run locally?

Yes, and no. While the script itself has no dependencies on this site and is only here for hosting, the default execution policy for Windows client computers permits individual commands, but does not allow scripts . The command above is downloading the script using the command irm (Invoke-RestMethod ), then executing the contents by piping it to the command iex (Invoke-Expression ). An alternative way to bypass the restriction is saving the script locally and invoking Get-Content -Raw .\update.ps1 | iex in an elevated PowerShell window (you'll need to move to the same directory as the script).

What is this doing exactly?

In short, this script is:

1. Checking if cloudflared is on your PC
2. Running cloudflared --update to allow the application to check for updates natively
3. Seeing if an update was downloaded
4. Applying the update to use

Why do I need to do it this way?

Normally, running cloudflared --update downloads the latest binary to C:\path\to\cloudflared.exe.new but does not actually replace the binary. Running this will also replace the binary, even if it's in use (it will restart the tunnel to do so).

What if I'm running this as a service?

After checking for and fetching the update, the script will then check to see if the service is already running. If it is, the service will be stopped so that the binary can be replaced. After replacing, the service will start again if it was previously running.

Can I automate this to run routinely?

At this moment, we do not have a guide for automating updates. This can be done via Task Scheduler, and will likely be the method chosen in the future.

What about Linux or Mac?

We do not have any plans for adding any scripts for Linux or Mac. Linux can be maintained much more easily via repo updating. Considering the various distros, we will not be providing guidance on this at this time.

I need help with something else.

Unfortunately, there are no official support channels for this at this time. You may feel free to reach out to me via Discord in the Cloudflare community server, however do not expect others to have answers.

I would like to contribute to this!

At this time this is not open for community contributions, but this may change.