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 added 5 commits 2024-04-21 04:15:43 +00:00
28b0b23104 Update docs for Arch Linux nginx setup
Alongside moving to certbot's nginx plugin, also use conf.d instead of
recreating the sites-{available,enabled} setup that Debian/Ubuntu uses.

Furthermore, also request a certificate for the media domain at the same
time since that's now required.
ci/woodpecker/pr/build-amd64 Pipeline is pending Details
ci/woodpecker/pr/build-arm64 Pipeline is pending Details
ci/woodpecker/pr/docs Pipeline is pending Details
ci/woodpecker/pr/lint Pipeline is pending Details
ci/woodpecker/pr/test Pipeline is pending Details
6115d1a4fe
Update gentoo install guide to use certbot-nginx
norm added 1 commit 2024-04-21 04:25:50 +00:00
ci/woodpecker/pr/build-amd64 Pipeline is pending Details
ci/woodpecker/pr/build-arm64 Pipeline is pending Details
ci/woodpecker/pr/docs Pipeline is pending Details
ci/woodpecker/pr/lint Pipeline is pending Details
ci/woodpecker/pr/test Pipeline is pending Details
6b04382539
Update certbot instructions for Alpine Linux
norm force-pushed docs-nginx-certbot from 6b04382539 to 588e2141e3 2024-04-21 04:26:51 +00:00 Compare
Oneric reviewed 2024-04-21 19:46:42 +00:00
Oneric left a comment
Member

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.
Member

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 to 4effa3806b 2024-04-21 22:01:27 +00:00 Compare
norm force-pushed docs-nginx-certbot from 4effa3806b to c066044c09 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 to 9d871d3264 2024-04-21 22:19:22 +00:00 Compare
norm force-pushed docs-nginx-certbot from 9d871d3264 to 6f1ac4b843 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.
Member

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 to f168c79c2d 2024-04-22 19:15:54 +00:00 Compare
Member

(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 to 0fa3fbf55e 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 merged commit 06847ca5f8 into develop 2024-04-24 17:08:40 +00:00
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 description provided.