cloudflare-docs icon indicating copy to clipboard operation
cloudflare-docs copied to clipboard

Unclear cloudflared update instructions for Zero Trust dashboard tunnels

Open etec-masterofsynapse opened this issue 3 years ago • 0 comments

Which Cloudflare product does this pertain to?

Cloudflare One

Existing documentation URL(s)

https://developers.cloudflare.com/cloudflare-one/connections/connect-apps/install-and-setup/installation#update-cloudflared

Section that requires update

Update cloudflared

What needs to change?

This section instructs users to execute cloudflared update to update the currently installed cloudflared instance. However this doesn't work in two instances:

  1. Cloudflared was installed by the package manager of the OS
  2. Cloudflared was installed through the instructions in the Zero Trust Dashboard which utilize dpkg to deploy the package

In both cases, executing cloudflared update will lead to the error:

cloudflared was installed by a package manager. Please update using the same method.

When using method 1 with the OS package manager, all is well and you can just run its upgrade mechanism to update cloudflared. But with method 2, dpkg can't update the cloudflared instance without manually downloading a new package.

How should it change?

Explain how users of the installation way through the Zero Trust Dashboard can upgrade cloudflared. One possibility would be to change the commands the Dashboard shows to the users so it adds the needed repository to the OS and installs cloudflared through that. Afterwards, you could still supply the cloudflared instance the needed service key through a second command to connect to the dashboard for zero-touch provisioning.

Additional information

No response

etec-masterofsynapse avatar Aug 27 '22 18:08 etec-masterofsynapse