-
-
Notifications
You must be signed in to change notification settings - Fork 214
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Add instuctions for updating cloudflared binary. #215
Conversation
Thanks for the submission. I'm not a fan of automated updates without intervention so I'm not going to approve but the other team members may have different opinions. |
The docs I added are simply calling that, actually (and then calling systemctl restart) - if you'd prefer, I can alter the docs to simply explain how to do an updating manually, and then just have a note you can automate it by placing it inside the weekly cron folder? |
Yeah, that sounds like a better way to document it. Have the manual process be the main topic and then add a note for how to automate. Bonus if you want to do |
@dschaper Done - I've updated the docs so the manual method is described first, and then there's a note on how to do automatic updating via cron. Also, I made a small comment earlier in the guide that cloudflared will also work with other DoH providers (so the same setup can be used for google DNS for example). |
@iUnknwn Can you rebase this on master? There have been some changes. |
Deploy preview for pihole-docs ready! Built with commit 3337b2a |
@dschaper Done - rebased onto master. |
Thanks, some linting comments, I'll check them over in a bit.
|
I don't think this patch is correct. If one has installed cloudflared following the existent guide, then cloudflared won't run as root so updating it with its built-in command can mess things up. I suggest that we focus on finishing #186 first and build on top of that. |
This overlaps with the majority of my PR - the only thing that still might be useful is the note about how cloudflared can be configured to use other DoH providers. Do you want me to update this PR, or open a new one just for that specific improvement? |
I think you should try keeping most of your changes and we see the diff. There are some differences including the cron job (which I thought is not needed) |
@XhmikosR OK - all of those changes should be in this PR - do you want me to do a rebase onto the current docs, or just leave what I currently have? |
Just rebase this branch and add any more info and we'll review it. |
Adds a section to the DNS-Over-HTTPS guide with instructions for how to ensure the cloudflared daemon is kept up-to-date.
Changed documentation to first list manual method to update the cloudflared binary, and then have a subsequent paragraph on automatic updating if desired by the user. Also, while small, added a note that cloudflared will work with other DoH providers (was useful when there was a cloudflare outage in my region).
Forgot to add sudo in front of the cloudflared/systemd command. Fixed in this commit.
Done - just rebased on top of master. |
docs/guides/dns-over-https.md
Outdated
CLOUDFLARED_OPTS=--port 5053 --upstream https://1.1.1.1/dns-query --upstream https://1.0.0.1/dns-query | ||
``` | ||
|
||
**Note:** The `cloudflared` binary will work with other DoH providers (for example, you could use https://8.8.8.8/dns-query for Google DNS). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
**Note:** The `cloudflared` binary will work with other DoH providers (for example, you could use https://8.8.8.8/dns-query for Google DNS). | |
**Note:** The `cloudflared` binary will work with other DoH providers (for example, you could use `https://8.8.8.8/dns-query` for Google DNS). |
docs/guides/dns-over-https.md
Outdated
sudo chown root:root /etc/cron.weekly/cloudflared-updater.sh | ||
``` | ||
|
||
The system will now attempt to update the cloudflared binary automatically, once per week. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The system will now attempt to update the cloudflared binary automatically, once per week. | |
The system will now attempt to update the cloudflared binary automatically, once per week. |
@XhmikosR done - changes made. |
...Actually, I'm re-reading this and I notice we now have two updating cloudflared sections, should the section section be renamed "Keeping Cloudflared Up-To-Date" or something like that? |
You need to merge your update changes with the current one. |
OK - changes merged. That said, I'm wondering if there might be a way to simply this guide considerably. The main reason to keep the manual configuration route is to give people an option to avoid running cloudflared as root, correct? If so, wouldn't it make more sense to simply write an extension unit file (as described here). That would let people configure the binary to run as its own non-root user, and it would prevent future updates from overwriting the change. If we did this, we'd be able to remove all the sections that refer to manual configuration, and I think it would make the guide considerably more readable (we'd no longer need two sub sections for each install, update, and delete step). |
Adds a section to the DNS-Over-HTTPS guide with instructions for how to ensure the cloudflared daemon is kept up-to-date.
This adds update instructions for cloudflared, which handles one part of issue #175