Custom Data Commons is deployed in Google Cloud Platform (GCP). This manual
describes how to install a custom Data Commons instance in an existing GCP
project (with id
From Google Cloud Console, open Cloud Shell by clicking on the icon, like below:
Set the environment variables
CONTACT_EMAILin the terminal:
export PROJECT_ID=<project_id> export CONTACT_EMAIL=<email_address>
Note: If this step fails, please contact us at with form with the errors.
[Optional] The default domain of the instance is
<PROJECT_ID>-datacommons.com. If you want to use an existing custom domain, set the environment variable:
Later on, you need to create a new DNS record by linking the domain with the IP address (from GCP project) from your domain provider.
Please run the following installation command inside the terminal. This may take up to 20 minutes to complete.
curl -fsSL https://raw.githubusercontent.com/datacommonsorg/website/custom-dc-v0.3.2/scripts/install_custom_dc.sh -o install_custom_dc.sh && \ chmod u+x install_custom_dc.sh && \ ./install_custom_dc.sh
You should get an email by Google domains that has the section pictured below. Please click on “Verify email now”.
Note: You may not get the verification email if you have verified Cloud Domains or Google Domains in the past. If you do not get the verification within 10 minutes, check GCP UI to see if the Cloud Domain is active. If it is active, then please skip this step. Below is what active Cloud Domains looks like.
Deploy a default Data Commons Instance:
First clone the Github repo
git clone https://github.com/datacommonsorg/website.git
Then update fields
projectin custom_dc_template.yaml with the actual GCP project ID.
Deploy to GKE by running:
./scripts/deploy_gke_helm.sh -e custom_dc_template -l us-central1-a
Go to GCP console to make sure pods are running successfully.