Update nginx config and install docs to use certbot's nginx plugin #752

Merged
floatingghost merged 7 commits from norm/akkoma:docs-nginx-certbot into develop 2024-04-24 17:08:40 +00:00
Contributor

This should make it less confusing to properly configure Let's Encrypt certificates and importantly allow for automatic renewals without futzing around.

I've left the *BSD stuff alone as I'm not that familiar with how things are done there.

Closes #747

This should make it less confusing to properly configure Let's Encrypt certificates and importantly allow for automatic renewals without futzing around. I've left the *BSD stuff alone as I'm not that familiar with how things are done there. Closes https://akkoma.dev/AkkomaGang/akkoma/issues/747
norm force-pushed docs-nginx-certbot from 6b04382539
Some checks are pending
ci/woodpecker/pr/build-amd64 Pipeline is pending
ci/woodpecker/pr/build-arm64 Pipeline is pending
ci/woodpecker/pr/docs Pipeline is pending
ci/woodpecker/pr/lint Pipeline is pending
ci/woodpecker/pr/test Pipeline is pending
to 588e2141e3
Some checks are pending
ci/woodpecker/pr/build-amd64 Pipeline is pending
ci/woodpecker/pr/build-arm64 Pipeline is pending
ci/woodpecker/pr/docs Pipeline is pending
ci/woodpecker/pr/lint Pipeline is pending
ci/woodpecker/pr/test Pipeline is pending
2024-04-21 04:26:51 +00:00
Compare
Oneric left a comment
Owner

looks good to me except for one thing in Gentoo instructions

looks good to me except for one thing in Gentoo instructions
@ -243,0 +236,4 @@
If that doesn't work the first time, add `--dry-run` to further attempts to avoid being ratelimited as you identify the issue, and do not remove it until the dry run succeeds. If that doesnt work, make sure, that nginx is not already running. If it still doesnt work, try setting up nginx first (change ssl “on” to “off” and try again). Often the answer to issues with certbot is to use the `--nginx` flag once you have nginx up and running.
If you are using any additional subdomains, such as for a media proxy, you can re-run the same command with the subdomain in question. When it comes time to renew later, you will not need to run multiple times for each domain, one renew will handle it.
Owner

The first paragraph after the certbot --nginx command talks about making sure nginx isn’t runnning and disabling SSL, but i think this was only relevant to the old way and probably now counterproductive.
The --dry-run hint on the other hand might be goo to add to all instruction versions.

The second paragraph about subdomain should have been obsoleted by the -d <media_domain> addition

The first paragraph after the `certbot --nginx` command talks about making sure nginx isn’t runnning and disabling SSL, but i think this was only relevant to the old way and probably now counterproductive. The `--dry-run` hint on the other hand might be goo to add to all instruction versions. The second paragraph about subdomain should have been obsoleted by the `-d <media_domain>` addition
Author
Contributor

I'll look at adding in the --dry-run stuff to the other install instructions. The rest should be fixed up now.

I'll look at adding in the `--dry-run` stuff to the other install instructions. The rest should be fixed up now.
norm marked this conversation as resolved
norm force-pushed docs-nginx-certbot from 588e2141e3
Some checks are pending
ci/woodpecker/pr/build-amd64 Pipeline is pending
ci/woodpecker/pr/build-arm64 Pipeline is pending
ci/woodpecker/pr/docs Pipeline is pending
ci/woodpecker/pr/lint Pipeline is pending
ci/woodpecker/pr/test Pipeline is pending
to 4effa3806b
Some checks are pending
ci/woodpecker/pr/build-amd64 Pipeline is pending
ci/woodpecker/pr/build-arm64 Pipeline is pending
ci/woodpecker/pr/docs Pipeline is pending
ci/woodpecker/pr/lint Pipeline is pending
ci/woodpecker/pr/test Pipeline is pending
2024-04-21 22:01:27 +00:00
Compare
norm force-pushed docs-nginx-certbot from 4effa3806b
Some checks are pending
ci/woodpecker/pr/build-amd64 Pipeline is pending
ci/woodpecker/pr/build-arm64 Pipeline is pending
ci/woodpecker/pr/docs Pipeline is pending
ci/woodpecker/pr/lint Pipeline is pending
ci/woodpecker/pr/test Pipeline is pending
to c066044c09
Some checks are pending
ci/woodpecker/pr/build-amd64 Pipeline is pending
ci/woodpecker/pr/build-arm64 Pipeline is pending
ci/woodpecker/pr/docs Pipeline is pending
ci/woodpecker/pr/lint Pipeline is pending
ci/woodpecker/pr/test Pipeline is pending
2024-04-21 22:07:46 +00:00
Compare
Author
Contributor

Added in the --dry-run troubleshooting steps to the setup instructions for all distros

Added in the `--dry-run` troubleshooting steps to the setup instructions for all distros
norm force-pushed docs-nginx-certbot from c066044c09
Some checks are pending
ci/woodpecker/pr/build-amd64 Pipeline is pending
ci/woodpecker/pr/build-arm64 Pipeline is pending
ci/woodpecker/pr/docs Pipeline is pending
ci/woodpecker/pr/lint Pipeline is pending
ci/woodpecker/pr/test Pipeline is pending
to 9d871d3264
Some checks are pending
ci/woodpecker/pr/build-amd64 Pipeline is pending
ci/woodpecker/pr/build-arm64 Pipeline is pending
ci/woodpecker/pr/docs Pipeline is pending
ci/woodpecker/pr/lint Pipeline is pending
ci/woodpecker/pr/test Pipeline is pending
2024-04-21 22:19:22 +00:00
Compare
norm force-pushed docs-nginx-certbot from 9d871d3264
Some checks are pending
ci/woodpecker/pr/build-amd64 Pipeline is pending
ci/woodpecker/pr/build-arm64 Pipeline is pending
ci/woodpecker/pr/docs Pipeline is pending
ci/woodpecker/pr/lint Pipeline is pending
ci/woodpecker/pr/test Pipeline is pending
to 6f1ac4b843
Some checks are pending
ci/woodpecker/pr/build-amd64 Pipeline is pending
ci/woodpecker/pr/build-arm64 Pipeline is pending
ci/woodpecker/pr/docs Pipeline is pending
ci/woodpecker/pr/lint Pipeline is pending
ci/woodpecker/pr/test Pipeline is pending
2024-04-21 22:35:51 +00:00
Compare
Author
Contributor

Forgot about the OTP stuff, that should be updated now.

Forgot about the OTP stuff, that should be updated now.
Owner

OTPs don’t have the --dry-run + nginx -t hints yet but otherwise good afaict

OTPs don’t have the `--dry-run + nginx -t` hints yet but otherwise good afaict
norm force-pushed docs-nginx-certbot from 6f1ac4b843
Some checks are pending
ci/woodpecker/pr/build-amd64 Pipeline is pending
ci/woodpecker/pr/build-arm64 Pipeline is pending
ci/woodpecker/pr/docs Pipeline is pending
ci/woodpecker/pr/lint Pipeline is pending
ci/woodpecker/pr/test Pipeline is pending
to f168c79c2d
Some checks are pending
ci/woodpecker/pr/build-amd64 Pipeline is pending
ci/woodpecker/pr/build-arm64 Pipeline is pending
ci/woodpecker/pr/docs Pipeline is pending
ci/woodpecker/pr/lint Pipeline is pending
ci/woodpecker/pr/test Pipeline is pending
2024-04-22 19:15:54 +00:00
Compare
Owner

(idk if you just hadn’t time to update both yet, but otp_redhat doesn’t have the troubleshooting hints yet, only normal OTP)

(idk if you just hadn’t time to update both yet, but otp_redhat doesn’t have the troubleshooting hints yet, only normal OTP)
norm force-pushed docs-nginx-certbot from f168c79c2d
Some checks are pending
ci/woodpecker/pr/build-amd64 Pipeline is pending
ci/woodpecker/pr/build-arm64 Pipeline is pending
ci/woodpecker/pr/docs Pipeline is pending
ci/woodpecker/pr/lint Pipeline is pending
ci/woodpecker/pr/test Pipeline is pending
to 0fa3fbf55e
Some checks are pending
ci/woodpecker/pr/build-amd64 Pipeline is pending
ci/woodpecker/pr/build-arm64 Pipeline is pending
ci/woodpecker/pr/docs Pipeline is pending
ci/woodpecker/pr/lint Pipeline is pending
ci/woodpecker/pr/test Pipeline is pending
2024-04-23 04:03:06 +00:00
Compare
Oneric approved these changes 2024-04-23 14:39:56 +00:00

seems sensible - I do wonder if we should at some point recommend caddy as a generic webserver given how it takes out the managing of certbot alltogether

seems sensible - I do wonder if we should at some point recommend caddy as a generic webserver given how it takes out the managing of certbot alltogether
floatingghost deleted branch docs-nginx-certbot 2024-04-24 17:08:40 +00:00
Author
Contributor

probably, caddy is a lot simpler to set up, though nginx does have a few useful things that isn't natively present in caddy like caching

probably, caddy is a lot simpler to set up, though nginx does have a few useful things that isn't natively present in caddy like caching
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
3 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
AkkomaGang/akkoma!752
No description provided.