Skip to content

Commit 18600d3

Browse files
authored
docs: add note about TLD and wildcards (coder#16008)
Adds docs to hopefully help others avoid coder#15708
1 parent 75fa8ca commit 18600d3

File tree

1 file changed

+5
-0
lines changed

1 file changed

+5
-0
lines changed

docs/admin/setup/index.md

+5
Original file line numberDiff line numberDiff line change
@@ -44,6 +44,11 @@ coder server
4444
or running [coder_apps](../templates/index.md) on an absolute path. Set this to
4545
a wildcard subdomain that resolves to Coder (e.g. `*.coder.example.com`).
4646

47+
> Note: We do not recommend using a top-level-domain for Coder wildcard access
48+
> (for example `*.workspaces`), even on private networks with split-DNS. Some
49+
> browsers consider these "public" domains and will refuse Coder's cookies,
50+
> which are vital to the proper operation of this feature.
51+
4752
If you are providing TLS certificates directly to the Coder server, either
4853

4954
1. Use a single certificate and key for both the root and wildcard domains.

0 commit comments

Comments
 (0)