Skip to content

docs(domains): add sslip.io domain details and usage guidelines - #586

Open
Cinzya wants to merge 1 commit into
coollabsio:nextfrom
Cinzya:feature/sslipio
Open

docs(domains): add sslip.io domain details and usage guidelines#586
Cinzya wants to merge 1 commit into
coollabsio:nextfrom
Cinzya:feature/sslipio

Conversation

@Cinzya

@Cinzya Cinzya commented Apr 27, 2026

Copy link
Copy Markdown
Member

Summary

  • Add a dedicated "sslip.io Domains" section to docs/knowledge-base/domains.md explaining what sslip.io is, when Coolify falls back to it (no Wildcard Domain set on the server), and what it's good for.
  • Call out the HTTPS gotcha inline: Let's Encrypt rate-limits the entire shared sslip.io zone, so auto-generated sslip URLs stay on http:// — switching them to https:// will fail certificate issuance. This matches Coolify's in-app warning (warning.sslipdomain) and the sslipDomainWarning() helper in bootstrap/helpers/shared.php.
  • Note in the DNS Validation section that *.sslip.io hostnames are automatically skipped during DNS validation, matching the early-return in validateDNSEntry().

Test plan

  • bun install && bun run dev, then open http://localhost:5173/docs/knowledge-base/domains and confirm the new "sslip.io Domains" section renders between the intro and "HTTPS & SSL Certificates".
  • Confirm the info and tip callouts render with the correct styles in both light and dark mode.
  • Click the in-page anchor #wildcard-domain and verify it scrolls to the existing Wildcard Domain section.
  • Click the external sslip.io and letsencrypt.org links and verify they carry the ?utm_source=coolify.io query param.
  • bun run build succeeds with no new VitePress errors (pre-existing unresolved-link warnings on lines 59/98/102/105/110 are unrelated to this change).

@github-actions github-actions Bot added the ✨ Maintainer PR author is a maintainer of this repository label Apr 27, 2026
@ShadowArcanist
ShadowArcanist changed the base branch from v4.x to next August 5, 2026 15:57
@ShadowArcanist ShadowArcanist added the 👥 Core Team Only Restricted to the core Coolify team for work. label Aug 5, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

👥 Core Team Only Restricted to the core Coolify team for work. ✨ Maintainer PR author is a maintainer of this repository

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants