Tutorial: Setting up HarperDB Cloud
Tags: database, tutorial, sql, microservices
Published: 2020-07-01 20:48:08

## Overview 
 
The goal of this tutorial is to give a very simple explanation of how to set up a HarperDB Cloud account and a free instance of HarperDB.   
 
### Signing Up 

* Go to https://studio.harperdb.io/sign-up
* Fill out the form with your details 
 

![](https://paper-attachments.dropbox.com/s_694AC5CA9308096771EF7B00CE87C94A0B19247B0A8F1B3279168F6A6C25589F_1593631741126_image.png)

* Click Sign Up For Free  
* You will then receive an email that looks like this: 


![](https://paper-attachments.dropbox.com/s_694AC5CA9308096771EF7B00CE87C94A0B19247B0A8F1B3279168F6A6C25589F_1593631864036_image.png)



* Make sure to copy your temporary password and then click Log into HarperDB Studio 
* Type in your email and temporary password
* You will then be asked to create a new password

* Note:  This is only for the management studio.  Your database creds are separate for each db instance.   Additionally, you will be able to invite other users to your organization once you login. * 

* Now click on your org 


![](https://paper-attachments.dropbox.com/s_694AC5CA9308096771EF7B00CE87C94A0B19247B0A8F1B3279168F6A6C25589F_1593632079387_image.png)

### Creating an Instance
* Now click on Create New HarperDB Cloud Instance 

![](https://paper-attachments.dropbox.com/s_694AC5CA9308096771EF7B00CE87C94A0B19247B0A8F1B3279168F6A6C25589F_1593632119706_image.png)

* Click on Create HarperDB Cloud Instance
![](https://paper-attachments.dropbox.com/s_694AC5CA9308096771EF7B00CE87C94A0B19247B0A8F1B3279168F6A6C25589F_1593632166435_image.png)

* Enter your Credentials 

*Note:  these are NOT the same as your Studio account.  This is for the super user you are creating on this database instance.   Username should NOT be in the form of an email.  Instance Name is for reference only.*  

![](https://paper-attachments.dropbox.com/s_694AC5CA9308096771EF7B00CE87C94A0B19247B0A8F1B3279168F6A6C25589F_1593632304933_image.png)

* Pick your instance specs.  You can start with a free version and always upgrade later.   Also pick the AWS region closest to you to reduce latency.  

![](https://paper-attachments.dropbox.com/s_09C1E3EC4CD39FB8BA6BE455CA9A3F593F112E47AFE1C751F7352036819262EE_1593636252765_image.png)

* Click Confirm Instance Details 
* Review your instance details 

*Note: The Instance URL is how you will access HarperDB with REST calls* 


![](https://paper-attachments.dropbox.com/s_694AC5CA9308096771EF7B00CE87C94A0B19247B0A8F1B3279168F6A6C25589F_1593632429266_image.png)



* Select I agree 
* Click Add Instance. 
**Note: Your HarperDB Cloud instance will be provisioned immediately, but it takes a few minutes to setup**
17.  In 5 to 10 minutes you will receive an email letting you know that your instance is ready. In the background we are spinning up a cloudformation template, a network load balancer, a vpn, and an ec2 instance all with HarperDB running on it. 
  
![](https://paper-attachments.dropbox.com/s_09C1E3EC4CD39FB8BA6BE455CA9A3F593F112E47AFE1C751F7352036819262EE_1593636645125_image.png)

* Log back into the Studio 
* Click back into your org 
* Click on your instance 


![](https://paper-attachments.dropbox.com/s_09C1E3EC4CD39FB8BA6BE455CA9A3F593F112E47AFE1C751F7352036819262EE_1593636945627_Screen+Shot+2020-07-01+at+2.53.26+PM.png)


* You are all set!  Make sure to check out the example code for help getting started! 
![](https://paper-attachments.dropbox.com/s_09C1E3EC4CD39FB8BA6BE455CA9A3F593F112E47AFE1C751F7352036819262EE_1593636931911_Screen+Shot+2020-07-01+at+2.55.00+PM.png)