How to Launch Collaborate (Using Google Cloud)

The Google Cloud Run button launches your own instance of Collaborate using the Google Cloud environment. Using Google Cloud requires you to setup a Google Project, enable Google Cloud billing and enable the Cloud Run API. Full setup instructions on using Google Cloud are here.

Once you've deployed your Cloud Run instance, you can manage your running instance from the Google Developers Console.

Google Cloud Run Setup

You'll have to go through three steps before you can begin the setup process for Collaborate.

  1. First, you'll need to set up a Google project. Click here and log into your Google account.

At the top of the page, click "Select a project."

  1. Then, click "New project."

  1. Enter a project name, and click "Create."

  1. Next, you'll need to enable billing on your Google account. Click on "Billing" in the left-hand column.

If you don't have a billing account, you'll be directed to set one up. If you already have a billing account, follow these directions.​

  1. Select "Link a billing account."

  1. Then click "Create Billing Account."

  1. Then follow the prompt and enter your information. Google will give you credit for a free trial.

Once you've entered your information, you'll get this confirmation.

  1. Finally, you'll need to enable the Cloud Run API. Click here and choose your project from the dropdown menu. Click "Continue."

You'll see this confirmation.

Deploy Collaborate

After you've followed these three steps, you'll be ready to deploy your instance of Collaborate.

  1. ​Click here to start. Make sure you're logged into the Google account you used for the setup process.

  2. Check the end-user agreement box (making sure you understand what you’re committing to) and click "Start Cloud Shell."

  1. The following message will appear. Click "Proceed."

  1. The page will start running a script.

It will then display the following message:

Value of COLLAB_ADMIN_USERNAME environment variable (Default admin account username.)

Enter the admin username you'd like to use for Collaborate, and hit enter.

  1. Then enter your email address, and hit enter. Type in a temporary password, and hit enter.

  1. Next, it will ask ask you to select the Google Cloud project. Use the arrow keys to select the project you created during the setup process, and hit "Enter."

  1. Then use the arrow keys to select your time zone, and hit "Enter."

  1. Then a script will begin to run. It make take a few minutes.

  1. Once the process is completed, you'll get a link marked in green. Click the link.

Now you can use the login information you put in to get started!