Custom pages domains & certificates #725

eepyjorin commented 2025年12月23日 00:47:34 +01:00

Certificates are automatically issued when a custom domain is successfully set up with Codeberg pages. However, the docs for custom domains do not say anything about this. It would be good to state outright that certificates are issued automatically, clarify exactly which steps must be taken before the cert is issued, approximately how long it should take to get a certificate, and restrictions that may apply.

The only mention related to certificates on the custom domains page is a blurb about CAA records. It may be appropriate to either create a new section about certificates on the page and put said blurb there, or to move the blurb to the troubleshooting page.

Certificates are automatically issued when a custom domain is successfully set up with Codeberg pages. However, the docs for custom domains do not say anything about this. It would be good to state outright that certificates are issued automatically, clarify exactly which steps must be taken before the cert is issued, approximately how long it should take to get a certificate, and restrictions that may apply. The only mention related to certificates on the custom domains page is a blurb about CAA records. It may be appropriate to either create a new section about certificates on the page and put said blurb there, or to move the blurb to the troubleshooting page.

Gusted commented 2025年12月23日 00:51:11 +01:00

@eepyjorin wrote in #725 (comment):

Certificates are automatically issued when a custom domain is successfully set up with Codeberg pages. However, the docs for custom domains do not say anything about this. It would be good to state outright that certificates are issued automatically, clarify exactly which steps must be taken before the cert is issued, approximately how long it should take to get a certificate, and restrictions that may apply.

Why? Did you run into troubles that required knowing this information?

@eepyjorin wrote in https://codeberg.org/Codeberg/Documentation/issues/725#issue-2975796: > Certificates are automatically issued when a custom domain is successfully set up with Codeberg pages. However, the docs for custom domains do not say anything about this. It would be good to state outright that certificates are issued automatically, clarify exactly which steps must be taken before the cert is issued, approximately how long it should take to get a certificate, and restrictions that may apply. Why? Did you run into troubles that required knowing this information?

eepyjorin commented 2025年12月23日 00:59:07 +01:00

I was a bit confused by the process. It was easy enough for me since I got the DNS and repo configuration right quickly and the certificate was subsequently issued quickly, but I spent some time looking for information about cert issuing as I wanted to make sure I hadn't missed anything.

I was a bit confused by the process. It was easy enough for me since I got the DNS and repo configuration right quickly and the certificate was subsequently issued quickly, but I spent some time looking for information about cert issuing as I wanted to make sure I hadn't missed anything.