Documentation:

Run UBOS on an Amazon Web Services EC2 virtual serverΒΆ

To run UBOS on EC2, click on the icon below and follow the Amazon wizard.

Here are some recommended values for the parameters that Amazon wants you to specify. However, UBOS is not very picky, so many different values should work as well.

  • Choose an instance type based on your budget and requirements. To try out UBOS and for personal sites, a “Free Tier” server should be sufficient.

  • Keep the root disk at 16GB. Magnetic is cheapest and fine for most personal sites.

  • Name it whatever you like.

  • You need to open the SSH, HTTP and HTTPS ports, otherwise you won’t be able to log into your server or access web apps it runs. Create a security rule that reflects that.

  • Create a new key pair unless you have a suitable one already. Name it “UBOS shepherd” if you like. Download the private key and save it on your local machine in a secure place. If you are on a Mac or a Linux box,

    chmod 400 <your-key-file>
    

    is a good idea.

Once your server has booted:

  1. Determine its public IP address. Then ssh into it as user shepherd:

    > ssh -i <your-key-file> -l shepherd <ip>
    
  2. Now: wait. UBOS needs to generate a few cryptographic keys before it is ready to use and initialize a few other things on the first boot. That might a little bit. To determine whether UBOS ready, execute:

    > systemctl is-system-running
    

    Wait until the output has changed from starting to running. If it is anything else, consult troubleshooting.

  3. Update UBOS to the latest and greatest:

    > sudo ubos-admin update
    
  4. You are now ready to set up your first app and site.