The purpose of this guide is to walk you through some of the setup required on your end with either your Amazon Web Services (AWS) account, your Google Cloud Platform (GCP) account, your Digital Ocean account, your Linode account or your Upcloud Account as well as some information on how to use Generator. This should be the first thing you read before using the application as there is some setup required on your part to get things started. Below I will get into a bit of the prep and explain what is required in order to ensure each account is set up and ready to go.
Amazon Web Services (AWS)
If you do not already have an account with AWS you are going to need to create one. AWS is great because they give you 750hrs per month of free t2 micro server usage. After signing up for an account and following the steps to authenticate your account you will need to sign in. Once you are signed in you will be greeted with their main console screen. Before we can go into the Generator there are a couple of things that we need. First, we need to visit here then head over to the Security Credentials section which is found under your AWS Profile name.
Once you get into your Security Credentials screen you will then have to head on down and click on the Access Keys (access key ID and secret access key) tab which will open up to the screen pictured below. Once you have this tab open you will need to press the Create New Access Key
Once you have pressed create new access key a prompt will be created where you will be able to see your secret key, access key ID and download a copy of it all. Ensure you keep the downloaded file in a safe place because if it is lost you will not be able to retrieve your secret access key again.
Once you have them created you will be able to go over to Generator and under the Credentials view you will click on Create, from the dialog select AWS. This will create a prompt where you will be able to set a nickname for these credentials, you will then be asked to input your Access Key and Secret Access Key and then you can press save.
With all that information saved you will then be able to start using Generator to create servers and proxies for you.
Google Cloud Platform (GCP)
Google Cloud Platform tends to be a little easier to deal with when it comes to setting up the application. First off you will need to head over to Google Clouds Console once you have created your account or simply signed in please take the time to ensure you have the correct project selected. If you do not have a project please create one now.
If this is a completely new GCP account, you will need to perform some additional steps. You will first need to head over to the side menu on the left-hand side. After opening the side menu, you will need to go down to Compute Engine and then click on VM instances. After clicking on that you will need to select your project from the drop-down menu and then you will need to create and attach a billing profile in order to enable it. After you have done that you will be ready to complete the next steps.
With the correct project selected you can click this link to head over to the page required to Create a Service Account
When you get to this screen, you will need to create a Service Account if you do not already have one. You can select a name for the account, the role for the account, and it should automatically create a service account ID. Once that is done ensure that you have JSON selected and press Create.
After pressing Create you will be prompted to download the file. Store it in a secure place as it will need to be on the same machine as Generator.
With this file downloaded you can head over to Generator where you will need to go to the Credentials view, click Create, then from the dialog select GCP, and click Next. After pressing next a prompt will appear asking you to set an account name and the file path to the JSON file that Google had you download when you pressed Create. After that press save.
With the credentials saved you will be now able to create servers and proxies using GCP and the provided service account.
Digital Ocean is great and easy to set up as well. First off if you don’t already have an account you’ll need to head over to Digital Oceans Website and create one. If you already have one simply login and use this link to go to the API section or navigate to it using the menu on the left.
Once here, press on the button Generate Token.
Here you will simply need to enter a name for your token, ensure that you have checked off the Write permission once you have entered a name press Generate Token.
Within the Generator navigate to the Credentials view, click Create, then from the dialog select Digital Ocean, and click Next. After pressing next a prompt will appear asking you to input the credential's name and your personal access token. After that press save.
Once you have clicked save you will be able to use Digital Ocean to create proxies.
Linode can be a bit trickier to find where to create your API token for. First off, as always if you do not already have an account you’ll need to head over to Linodes website and create one. You’ll need to verify the email on the account as well as link a billing right away before you can use the account. If you already have an account you’ll need to go ahead and login. Once logged in you can either Click Here to take you to the API Token section under my profile or navigate their manually by clicking on your profile name
Once in My Profile click on API tokens, then click on Add a Personal Access Token and you then you will be able to create a token.
Here you will need to create your token name, and select the Select All under read/write access. After that click submit and you will be met with a screen showing you your Personal Access Token.
You’ll need to save this token so that you can add it to Generator. Ensure you copy and paste it either to a file, or directly into Generator. Within the Generator navigate to the Credentials view, click Create, then from the dialog select Linode, and click Next. After pressing next a prompt will appear asking you to set the credential's name and your personal access token. After that press save.
UpCloud is very easy and simple to setup. Please note, in order to use Upcloud in the Generator, Upcloud requires you to deposit at least $10 into your account.
First, create an account on UpCloud. The credentials you used to create an account will be used in the credentials section in Generator. Once you have created your account and deposited $10 navigate to your account overview. Under the Permissions tile on your account allow API Key connections from All addresses and then click Save.
After that, open Generator. Navigate to the Credentials view, click Create, then from the dialog select UpCloud, and click Next. After pressing next a prompt will appear asking you to input the credential's name, the account username, and the account password. After that press save.
Once you have added the credentials you will be able to create proxies using UpCloud!