Documentation

menu
HostingIntroductionBranch HostingPull-request DeploymentsSecretsPersistenceDebuggingMultiple ServersCustom DomainsRaw DomainsExample: Typescript & GoExample: JitsiExample: RSS BridgeExample: Tiny Tiny RSSExample: SearxActionsInstalling Nixyaml configNix FlakesWhat Garnix CI doesIncremental BuildsUsing Private InputsCachingEnterprise installationsGitHub Actions IntegrationBadgesFOD ChecksGarnModulesNodejsHaskellRustPostgreSQLUseropen source

Custom domainsshare

If you want to use a custom domain, add a CNAME record in your DNS provider to point to the correct deployment. For example:

www.mydomain.com      CNAME       myServer.branch.repo.org.garnix.me

garnix will generate TLS certificates on the fly for your custom domain on the first request!

Note that this does not work for apex domains.

Alternatively you can use raw domains. In this case, you can use an ALIAS record, and it will work even at the apex. For example:

mydomain.com      ALIAS       myServer.branch.repo.org.raw.garnix.me

If you use raw domains, though, you will have to manage TLS certificates yourself, and you may have a few seconds of downtime between deployments.