Skip to content

Commit 704dbe0

Browse files
committed
docs: custom domain debug section
1 parent a914d07 commit 704dbe0

File tree

3 files changed

+84
-6
lines changed

3 files changed

+84
-6
lines changed

posts/pgs.md

Lines changed: 34 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -240,7 +240,7 @@ subdomain entry `_pgs`.
240240

241241
```
242242
subdomain.yourcustomdomain.com. 300 IN CNAME pgs.sh.
243-
_pgs.subdomain.yourcustomdomain.com. 300 IN TXT "{user}-{project}"
243+
_pgs.subdomain.yourcustomdomain.com. 300 IN TXT {user}-{project}
244244
```
245245

246246
## Example: Top-Level Domain
@@ -253,7 +253,7 @@ Resulting in:
253253

254254
```
255255
erock.io. 300 IN CNAME pgs.sh.
256-
_pgs.erock.io. 300 IN TXT "erock-kittens"
256+
_pgs.erock.io. 300 IN TXT erock-kittens
257257
```
258258

259259
Here's an example of what it looks like inside cloudflare:
@@ -270,7 +270,38 @@ Resulting in:
270270

271271
```
272272
meow.erock.io. 300 IN CNAME pgs.sh.
273-
_pgs.meow.erock.io. 300 IN TXT "erock-kittens"
273+
_pgs.meow.erock.io. 300 IN TXT erock-kittens
274+
```
275+
276+
Depending on your DNS, this could take some time to fully switch over.
277+
278+
## Debug custom domains
279+
280+
We have an endpoint to check whether or not custom domains are setup:
281+
282+
```
283+
curl -i 'https://pgs.sh/check?domain=meow.erock.io'
284+
```
285+
286+
First check the main record:
287+
288+
```bash
289+
dig meow.erock.io
290+
291+
; <<>> DiG 9.18.36 <<>> meow.erock.io
292+
;; QUESTION SECTION:
293+
;meow.erock.io. IN A
294+
295+
;; ANSWER SECTION:
296+
meow.erock.io. 60 IN A 129.158.37.104
297+
```
298+
299+
Then check the `TXT` record:
300+
301+
```bash
302+
dig -t txt +short _pgs.meow.erock.io
303+
304+
erock-kittens
274305
```
275306
276307
# Site customization

posts/prose.md

Lines changed: 27 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -368,11 +368,35 @@ _prose.subdomain.yourcustomdomain.com. 300 IN TXT erock
368368

369369
> We are replacing `{user}` token with the username `erock` as an example.
370370
371-
Depending on your DNS, this could take some time to fully switch over. We have
372-
an endpoint to check whether or not custom domains are setup:
371+
Depending on your DNS, this could take some time to fully switch over.
373372

373+
## Debug custom domains
374+
375+
We have an endpoint to check whether or not custom domains are setup:
376+
377+
```bash
378+
curl -i 'https://prose.sh/check?domain=subdomain.yourcustomdomain.com'
374379
```
375-
curl -i 'https://prose.sh/check?domain=example.com'
380+
381+
First check the main record:
382+
383+
```bash
384+
dig subdomain.yourcustomdomain.com
385+
386+
; <<>> DiG 9.18.36 <<>> subdomain.yourcustomdomain.com
387+
;; QUESTION SECTION:
388+
;subdomain.yourcustomdomain.com. IN A
389+
390+
;; ANSWER SECTION:
391+
subdomain.yourcustomdomain.com. 60 IN A 129.158.37.104
392+
```
393+
394+
Then check the `TXT` record:
395+
396+
```bash
397+
dig -t txt +short _prose.subdomain.yourcustomdomain.com
398+
399+
erock
376400
```
377401
378402
<hr />

posts/tuns.md

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -140,6 +140,29 @@ You may want to pre-select the region you connect to. Try pinging `ash.tuns.sh`
140140
or `nue.tuns.sh` to find the instance closest to you (lowest latency), and use
141141
that for both your SSH connection and CNAME.
142142

143+
## Debug custom domains
144+
145+
First check the main record:
146+
147+
```bash
148+
dig customdomain.example.com
149+
150+
; <<>> DiG 9.18.36 <<>> customdomain.example.com
151+
;; QUESTION SECTION:
152+
;customdomain.example.com. IN A
153+
154+
;; ANSWER SECTION:
155+
customdomain.example.com. 60 IN A 141.148.85.124
156+
```
157+
158+
Then check the `TXT` record:
159+
160+
```bash
161+
dig -t txt +short _sish.customdomain.example.com
162+
163+
SHA256:mVPwvezndPv/ARoIadVY98vAC0g+P/5633yTC4d/wXE
164+
```
165+
143166
# tunmgr
144167
145168
A tunnel manager for docker services.

0 commit comments

Comments
 (0)