Skip to content

Commit af40942

Browse files
committed
chore: update invalid ssl certs
1 parent 8ca6436 commit af40942

1 file changed

Lines changed: 23 additions & 8 deletions

File tree

‎common-issues/invalid-ssl.md‎

Lines changed: 23 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,35 @@
11
# Invalid SSL
22

3-
## Reverse Proxy Enabled
3+
## Cloudflare
44

5-
### Cloudflare
5+
### Deeply Nested Subdomains
66

7-
If you are using a deeply nested subdomain such as `*.5stack.example.com`, Cloudflare's free SSL certificate does not cover these domains. You must purchase an SSL certificate using their Advanced Certificate Manager.
7+
If you are using a deeply nested subdomain such as `*.5stack.example.com`, note that Cloudflare's free SSL certificate does **not** cover these domains. To secure deeply nested subdomains, you must purchase an SSL certificate through Cloudflare's Advanced Certificate Manager.
88

9-
## Not Using a Reverse Proxy (5Stack-Generated SSL Certificates)
9+
### Cloudflare Proxy (not to be confused with reverse proxies)
10+
11+
If you are using Cloudflare's proxy and **not** using a reverse proxy, the 5Stack k3s cluster will attempt to generate its own SSL certificates using Let's Encrypt.
12+
13+
However, when Cloudflare's proxy is enabled, it blocks direct HTTP requests to your server. This prevents Let's Encrypt from verifying your domain and issuing SSL certificates, causing certificate generation to fail.
14+
15+
To resolve this, disable the Cloudflare proxy. Also, ensure that any automatic HTTP to HTTPS redirects are turned off; otherwise, Let's Encrypt will still be unable to complete the verification process and the issue will persist.
16+
17+
## Debugging
1018

1119
If you are not using a reverse proxy, 5Stack generates its own SSL certificates. Occasionally, these certificates may become invalid, which can lead to SSL errors when accessing your site.
1220

13-
To resolve this issue and regenerate the SSL certificates:
21+
To fix this and regenerate the SSL certificates:
1422

1523
1. Go to your 5Stack installation directory.
1624
2. Run `git pull` to ensure you have the latest updates.
1725
3. Regenerate the certificates by running:
18-
```sh
19-
./fix-ssl.sh
20-
```
26+
27+
```sh
28+
./fix-ssl.sh
29+
```
30+
31+
Wait a couple of minutes, then check the status of your SSL certificates by running:
32+
33+
```sh
34+
./debug.sh
35+
```

0 commit comments

Comments
 (0)