Hubs

Hubs

  • Hubs Foundation
  • Docs
  • GitHub
  • Help
Edit

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:
    • Why use Hubs Cloud vs. hubs.mozilla.com?
    • Personal vs. Enterprise
    • Cost Information
  4. Create an SSH keypair to access your servers
    • Follow AWS guide to create the SSH keypair in your deployment region
    • Deployment region is in the upper right corner with your username and support
    • Save the private key using preferred format

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
    • Any issues? Check out AWS Troubleshooting for solutions to common problems.
  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
    • For immediate entry to your HC instance, verify individual email addresses Follow #1 Verify individual email addresses for administrators
  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.

  • Before creating the Hubs Cloud Stack
  • Deploy your Hubs Cloud Stack
  • After Deployment Admin Setup
Hubs
Docs
IntroductionSetting Up Your HubHubs FundamentalsSpoke DocumentationFor CreatorsFor DevelopersAdministration
Community
Discord Chat
More
HubsSpokeGitHub
Copyright © 2024–2025 Hubs Foundation. Hubs Documentation available under the Creative Commons Attribution-ShareAlike 3.0 Unported (CC BY-SA 3.0) license.