Getting Started is Easy
We'll walk you through the simple steps below to spin up your first network.
Sign up for both an AWS and NetFoundry Accounts if you don't have one. They're free.
2. CREATE YOUR NETWORK
a. Log into your NetFoundry console
b. If you have not created a network yet, “Create A New Network” and give it a name (ex: NFdemo)
c. It will take approximately 3-5 minutes for you network to be created. While the network is being created, the icon to the left of the network name will spin. Once your network is ready, the icon turns green.
3. ADD A NETFOUNDRY GATEWAY
a. From the NetFoundry Console left-hand navigation, select GATEWAYS
b. In the upper right, click the + sign to add a gateway
c. Select the “Create an AWS Gateway” option
d. Give your gateway a name (ex: gwDemo)
e. From the dropdown menu, select the region in which you plan to launch the AWS gateway. Hit the “Create” button
f. Click on your Gateway Registration Key (this will copy it to your clipboard)
g. Hit Esc icon in upper right to close the window
4. INSTALL NETFOUNDRY MULTICLOUD GATEWAY FOR AWS
a. Click here to add NetFoundry MultiCloud Gateway to your AWS account – this will take you to your AWS account
b. CloudFormation will launch in the last region your account was signed in. If you would like to launch in a different region, simply switch regions from the drop down. Please be sure you are launching in the same region you selected your NetFoundry gateway to be in (from 3.e above).
c. Once in the CloudFormation Console, the template should already be filled in. Click Next to continue.
d. Paste your Gateway Registration key in the appropriate field. Click Next to continue.
e. On the next page (“Options”) – leave all defaults. Click Next to continue.
f. From the Review page… Click Create to launch the stack
g. This CloudFormation will create a simple VPC, subnet, routing table, internet gateway & two (2) EC2 instances along with a security group to allow port 80(http) from anywhere to the Demo App.
• One t2.micro for the Hello World web page
• One t2.micro for the NetFoundry MultiCloud Gateway
h. Once the stack is launched, go to the CloudFormation “Output” section of the stack just created. You will find the internal IP address of the Demo App you will need for the next section. You can also test the external URL of the Demo App to make sure it’s accessible. The internal URL will only work once the NFN network is complete. (This could take 2-3 minutes)
Before you can start using the NetFoundry CloudFormation template, you will need to accept the software terms in the AWS Marketplace.
- Login to AWS if needed.
- Click on the "Manual Launch" tab
- Click on "Accept Software Terms"
5. CREATE A NETFOUNDRY SERVICE
a. From the NetFoundry Console left-hand navigation, select SERVICES
b. In the upper right, click the + sign to add a service
c. Select “Create an IP Host Service”
d. Add a service name (ex: svcDemo)
e. For IP address, use the private IP copied from above (step 4.h)
f. Port/range = 80
g. Intercept IP can be anything you want (ex: 188.8.131.52), but it’s recommended to use the private IP copied from step (4.h) – this will be the IP address you use to internally access the Hello World web page
h. Protocol Type = TCP/UDP
i. For the gateway, select the gateway you created above
j. Hit the “Create” button (NOTE: The Service you just created may take a couple minutes to complete before it becomes available in the list – the icon will turn GREEN when it is ready)
6. CREATE A NETFOUNDRY CLIENT
a. From the NetFoundry Console left-hand navigation, select CLIENTS
b. In the upper right, click the + sign to add a client
c. Add a client name (ex: MikesMac)
d. From the Location dropdown menu, select the region closest to where you are located (NetFoundry uses this location information to optimize network)
e. Hit the “Create” button
f. Copy the client registration key to your clipboard
g. Hit Esc icon in upper right to close the window
7. INSTALL NETFOUNDRY CLIENT
a. Go to netfoundry.io/resources/support/downloads and download the client for your Mac or PC
b. Follow the install instructions and enter the client registration key you copied (step 6.f)
8. CREATE NETFOUNDRY APPWAN
a. Make sure your Service in Step 5 has completed (the icon next to the Service name will be green)
b. From the NetFoundry Console left-hand navigation, select APPWANS
c. In the upper right, click the + sign to add a new AppWAN
d. Add an APPWAN NAME (ex: HelloWorld)
e. From the Available Clients list, click on the Client you added above (step 6.c) to move to SELECTED GROUPS, CLIENTS OR GATEWAYS
f. From the Available Services list, click on the Service you added above (step 5.d) to move to SELECTED SERVICES (NOTE: If the Service you created is not available, it may be still completing to be built)
g. Hit the “Create” button
9. TEST CONNECTION WITH THE HELLO WORLD WEBPAGE
a. Make sure your NetFoundry client is running
• For Mac: Open NFN Client in Applications
• For PC: Open NFN Client from the Start Menu
b. From a browser, enter the intercept IP you entered above (step 5.g)
c. The Hello World webpage should come up
d. Turn of the NetFoundry client
e. Refresh your browser
10. REMOVAL of AWS RESOURCE, ONCE DEMO IS COMPLETE.
a. From the AWS Console, Select the service “CloudFormation”
b. Select the stack “NFNDemo” from the list
c. From the “Actions” menu, select “Delete Stack”