Deploy Your Game

Games are hosted on our high-performance CDN. All games have a *.playpass.games subdomain, and you can also use your own domain.

Deploying

This command will deploy your game to https://yourgame.playpass.games:

playpass deploy

Branch previews

Use the --prefix parameter to create an alternate subdomain:

playpass deploy --prefix mytest

This will deploy the game to https://mytest--yourgame.playpass.games. This can be used to deploy branches to QA for testing.

Custom domains

A custom domain name (yourgame.com) can be setup with the CLI. You can then set the domain when deploying your game. The final step is to create a DNS alias entry in your provider pointing to the url returned to you.

CLI

Use the playpass custom-domain create command first:

playpass custom-domain create <domain> --certificate <certificatePath> --privateKey <privateKeyPath> [--certificateChain <certificateChainPath>]

You can also create it outside of your game's directory with the game flag:

playpass custom-domain create <domain> [--game <gameId>]

To set up a custom domain with the CLI you need to provide the domain (e.g. foo.example.com). You will be required to create two cname records in your DNS provider for the domain to be configured. After the domain is created the CLI will print your custom domain's distribution URL on your terminal, use it to configure an alias record in your DNS provider. You can always run playpass custom-domain get to see your game's custom domain.

You can delete the custom domain with playpass custom-domain delete.

Certificates

If you do not have a certificate for your domain yet, you can easily create one with certbot. Follow the installation instructions on their website to install and create a certificate for your domain. You can alternatively configure it manually with the following command:

sudo certbot certonly --manual --preferred-challenges dns -d "example.com"

The certificate, private key and chain should now be at /etc/letsencript/live/example.com/.