Skip to main content
Version: 5.0.0

AWS Quick Start Guide

Amazon Web Services (AWS) offers reliable, scalable, and inexpensive cloud computing services. We offer a dedicated repository to help you deploy N|Solid on AWS quickly and easily. We have several CloudFormation templates already written, as well as a list of AMI IDs for every region.

License Key​

If you don't already have a license key, please visit the NodeSource Accounts website to start your trial service.

Getting Started​

Easily run N|Solid on AWS using our CloudFormation templates in the dedicated GitHub repository. You can find a list of templates and their descriptions in the README.md. Once you find a template that you want to use, follow these steps to use the CloudFormation templates in nsolid-aws:

  1. Find the template you want to run in the /templates folder, then click the Deploy to AWS button.

  2. This will open up CloudFormation in your own account. Click the Next button.

  3. Fill in the required parameters and change the Stack Name if desired. Then click the Next button.

  4. Adjust any CloudFormation options if desired. Click Next.

  5. If the template requires IAM capabilities, you will need to check the "I acknowledge that AWS CloudFormation might create IAM resources with custom names." box. Once you are ready, click the Create button.

Launch Stack CloudFormation

AMI List​

You can also use our N|Solid AMIs for your own projects. See AMI-LIST.md for a full list of AMI IDs in every region.

Running Node Applications in N|Solid​

ssh into the machine as the ubuntu user and set these four N|Solid environment variables:

$ ssh -i ~/.ssh/your-aws-key.pem ubuntu@<ip-address>

$ NSOLID_COMMAND=localhost:9001 \
$ NSOLID_DATA=localhost:9002 \
$ NSOLID_BULK=localhost:9003 \
$ NSOLID_APPNAME="My_Application" node app.js

You can customize the name of your application in the N|Solid Console by changing the NSOLID_APPNAME environmental variable. If you do not specify an app name, N|Solid will look for a name property in your package.json, and if that is not found, your application name will default to "untitled application".

You are now ready to use N|Solid for your own applications!

Configuring N|Solid Console​

Process Management​

  • Nginx: /etc/init.d/nginx
  • N|Solid Console: /etc/init.d/nsolid-console

Nginx​

The configuration for the external proxy is located at /etc/nginx/sites-enabled/nsolid-nginx.conf.

N|Solid Console​

The default configuration file is located at /etc/nsolid/console-config.toml with all artifacts stored at /var/lib/nsolid/console.