When you publish a Koji app, it’s automatically assigned a permalink, based on your user name, that lives on the withkoji.com domain.
For example: withkoji.com/~johnsmith789/my-video-game.
You have the option of additionally serving your app at a custom domain.
This option can be helpful if you already own a domain that ties into your marketing strategy, or if you want to create a URL that is easier to identify or verbalize.
The Koji platform has several root domains that you can use at no cost, including:
withkoji.com
koji.sh
koji.game
You can create a custom domain by appending a Koji root domain to a subdomain of your choosing.
For example, if you append ".koji.game" to "myvideogame", your custom domain name will be myvideogame.koji.game.
You can also use a domain name that you purchase from somewhere like Google Domains or Namecheap.
Then you can make your domain name almost anything you want it to be.
For example: thenextgreatvideogame.com.
|
Note
|
You can assign only one Koji subdomain to a Koji app. If you’ve already assigned a subdomain and you want to change it, follow the steps for deleting a domain. Then you can assign the new one. You can assign as many domains as you want to a Koji app if they are domains you own. |
Open the Koji app and go to .
Click Add New Domain.
Select Subdomain.
Click Next.
Select a root domain.
Enter the subdomain.
Click Save. If the domain name you chose is already taken, "That domain is not available" will be displayed. If the domain name is available, the complete domain name will be displayed.
Click the domain name. You should see a message verifying that your custom domain has been successfully assigned to the Koji app.
Click Open to go to the new URL. Your app should be displayed.
|
Note
|
Custom domains that use a Koji root domain automatically manage HTTPS termination. This means that your app’s traffic is secured with HTTPS, but does not require any special configuration, like listening on both ports 80 and 443, serving certificates and managing certificate lifecycle and renewal, or dealing with mixed-security content. |
If you buy your own domain name from somewhere like Google Domains or Namecheap, you can easily configure that domain to serve your Koji app. Simply register your domain in your app, and then use your domain provider’s management tools to configure the appropriate DNS records.
Open the Koji app and go to .
Click Add New Domain.
Select A domain you own.
Click Next.
Enter your complete domain name.
Click Save. The domain name should be displayed.
Click the domain name. You should see a message verifying that your custom domain has been successfully assigned to the Koji app.
Follow the steps for configuring DNS records.
Click Open to go to the new URL. Your app should be displayed.
If you want to host your Koji app on a subdomain of your custom domain name (for example, www.mycustomdomain.com or game.mycustomdomain.com), you will need to use your domain provider’s tools to add a CNAME record for that subdomain (www or game) that points to cnames.withkoji.com.
If you want your app to be served from the root domain name (mycustomdomain.com), you need to add an A record for the domain’s root that maps it to the Koji platform’s IP block:
151.101.1.78
151.101.65.78
151.101.129.78
151.101.193.78
If you are configuring a root domain via A records, it is also recommended to configure AAAA records to support IPv6. The Koji platform’s IPv6 block is:
2a04:4e42::334
2a04:4e42:200::334
2a04:4e42:400::334
2a04:4e42:600::334
2a04:4e42:800::334
2a04:4e42:a00::334
2a04:4e42:c00::334
2a04:4e42:e00::334
Different domain providers have different tools for managing DNS records, and some of those tools are more complex than others. If you have questions about how to configure your domain’s DNS records, please connect with us on Discord and someone will be happy to help.
Open the Koji app and go to .
Click the domain name you want to delete.
Click Delete Domain.
Click Yes, delete.