Skip to main content

AWS Quick Start

Before creating the Hubs Cloud Stack​

Follow along: Video Tutorial: How to Deploy Hubs Cloud Part 1

  1. Create an account on AWS and log into the console.
  2. Register or setup any domains in AWS Route 53, you'll need at least 2 domains. For example: myhub.com and myhub.link. See Domain Recipes for more info.
  3. Review relevant docs:
  4. Create an SSH keypair to access your servers

Deploy your Hubs Cloud Stack​

Follow along: Video Tutorial: How to Deploy Hubs Cloud Part 2

  1. Go to https://hubs.mozilla.com/cloud and choose which Hubs Cloud product to deploy
  2. Click "Continue to Subscribe" on Hubs Cloud Personal AWS Marketplace page
  3. Click "Continue to Configuration"
  4. Select your desired "Region"
    • For Enterprise select your desired "Delivery Method":
      • "Multi-server"
      • "Single Server"
    • Then your desired "Region"
  5. Click "Continue to Launch"
  6. Change "Select a launch action" dropdown to "Launch CloudFormation" then click "Launch"
  7. Select "Next" in bottom right corner of the "Create stack" or "Specify template" page
  8. In specify stack details:
    • Name your stack, something like: "your-hub-name-1"
    • Account Configuration Administrator Email Address
      • NO CAPITALIZED LETTERS
      • The admin for your hub
    • For these parameters use Domain Recipes for guidance: Site Domain Name, Site is Set Up On Route 53, Internal Domain, Short Link Domain, Outgoing Email Domain, and Outgoing Email Subdomain Prefix
      • Double check for no typos!
    • Choose your KeyPair from Before Creating the Stack: Step 4
    • If you are using an existing domain not on AWS Route 53, you'll need to perform a few extra steps - See Using an existing domain
    • Choose a setting for Restrict SSH Access
    • Review the other options, or keep the defaults. You can update most of these later via a Stack Update
  9. Select "Next"
  10. Agree to Terms of Service checkboxes
  11. Wait 20-30 minutes for the stack to complete deploying
  12. Confirm your Administrator Email Address in your inbox, it will be confirming your email in N. Virginia
  13. After stack is created, hit your site at your primary domain, wait 20 to 30 seconds
  14. Login with your Administrator Email Address

After Deployment Admin Setup​

Follow along: Video Tutorial: How to Deploy Hubs Cloud Part 3

  1. Set up AWS Simple Email Service (SES) in N. Virginia (us-east-1) for all deploy regions to get out of the SES Sandbox Follow #2 Send request to AWS for limit increase
  2. Follow guide in Admin Panel > Content CDN menu to setup Cloudflare workers to decrease costs
  3. Proceed with process to add scenes and avatars in the Getting Started with Hubs Cloud guide!

Congrats you've successfully set everything up!

Any issues deploying?​

Check out AWS Troubleshooting for solutions to common problems.