Hubs Cloud Personal

Create your own immersive spaces faster than ever. Hubs Cloud Personal deploys a single server for private, collaborative immersive rooms that can be accessed on your desktop, mobile phone, or VR headset. Choose avatars, create private rooms with custom scenes, invite people to join you, and collaborate in exciting new ways using voice and text chat, media from around the web, interactive drawing tools, and more.

Software Included

Creating an App using the Control Panel

Click the Deploy to DigitalOcean button to create a Droplet based on this 1-Click App. If you aren’t logged in, this link will prompt you to log in with your DigitalOcean account.

Creating an App using the API

In addition to creating a Droplet from the Hubs Cloud Personal 1-Click App using the control panel, you can also use the DigitalOcean API. As an example, to create a 4GB Hubs Cloud Personal Droplet in the SFO2 region, you can use the following curl command. You need to either save your API access token) to an environment variable or substitute it in the command below.

curl -X POST -H 'Content-Type: application/json' \
         -H 'Authorization: Bearer '$TOKEN'' -d \
        '{"name":"choose_a_name","region":"sfo2","size":"s-2vcpu-4gb","image": "mozilla-hubscloudpersona-18-04"}' \
        "https://api.digitalocean.com/v2/droplets"

Getting Started After Deploying Hubs Cloud Personal

It’s easy to get Hubs Cloud Personal up and running on a DigitalOcean droplet.

• First, you’ll need two registered domain names, one for your site and one for short room links. We recommend using .link domains for short links.

• If possible, add your two domains to your DigitalOcean project.

  • If you do so, we’ll be able to automatically add the necessary DNS records for you.
  • Otherwise, you’ll have to add the necessary DNS records yourself. The setup process will tell you what records to add.

• Hubs Cloud uses email magic links to log in. You’ll need SMTP connection info from an email provider to send these emails.

  • We recommend using SendGrid and using port 2525 to prevent firewall blocking. To use SendGrid, log in and go to https://app.sendgrid.com/guide/integrate/langs/smtp to get an SMTP username and password.

• If you want additional storage for uploads, avatars, and scenes, you should attach a block storage volume.

• Create a writable DigitalOcean API key. This will be needed during during setup for configuring DNS, firewall, etc. It won’t be saved and you can remove it from your account afterwards.

• Once your droplet has started, SSH in to complete the setup process.

Need more help? Visit https://hubs.mozilla.com/docs/hubs-cloud-do-quick-start.html for full documentation and support.